Submit an Apple Messages for Business business for review

POST

/v1/amb/business-accounts/{business_account_id}/submissions

const result = await bird.amb.businessAccounts.submissions.create(
  "abz_01krdgeqcxet5s7t44vh8rt9mg",
  {
    readiness_attachment_id: "tca_01krdgeqcxet5s7t44vh8rt9mg",
    use_cases_attachment_id: "tca_01krdgeqcxet5s7t44vh8rt9mh",
    video_attachment_id: "tca_01krdgeqcxet5s7t44vh8rt9mj",
  },
);
console.log(result);

result = client.amb.business_accounts.submissions.create(
    'abz_01krdgeqcxet5s7t44vh8rt9mg',
    readiness_attachment_id='tca_01krdgeqcxet5s7t44vh8rt9mg',
    use_cases_attachment_id='tca_01krdgeqcxet5s7t44vh8rt9mh',
    video_attachment_id='tca_01krdgeqcxet5s7t44vh8rt9mj',
)
print(result)

result, err := client.Amb.BusinessAccounts.Submissions.Create(ctx, "abz_01krdgeqcxet5s7t44vh8rt9mg", bird.AmbBusinessAccountsSubmissionsCreateParams{
	ReadinessAttachmentID: "tca_01krdgeqcxet5s7t44vh8rt9mg",
	UseCasesAttachmentID:  "tca_01krdgeqcxet5s7t44vh8rt9mh",
	VideoAttachmentID:     "tca_01krdgeqcxet5s7t44vh8rt9mj",
})
if err != nil {
	log.Fatal(err)
}
fmt.Println(result)

$bird->amb->businessAccounts->submissions->create(
    'abz_01krdgeqcxet5s7t44vh8rt9mg',
    (new Model\AMBBusinessAccountSubmissionCreate())
        ->setReadinessAttachmentId('tca_01krdgeqcxet5s7t44vh8rt9mg')
        ->setUseCasesAttachmentId('tca_01krdgeqcxet5s7t44vh8rt9mh')
        ->setVideoAttachmentId('tca_01krdgeqcxet5s7t44vh8rt9mj'),
);

bird amb business-accounts submissions create <business-account-id> \
  --readiness-attachment-id tca_01krdgeqcxet5s7t44vh8rt9mg \
  --use-cases-attachment-id tca_01krdgeqcxet5s7t44vh8rt9mg \
  --video-attachment-id tca_01krdgeqcxet5s7t44vh8rt9mg

curl -X POST "https://us1.platform.bird.com/v1/amb/business-accounts/{business_account_id}/submissions" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "readiness_attachment_id": "tca_01krdgeqcxet5s7t44vh8rt9mg",
    "use_cases_attachment_id": "tca_01krdgeqcxet5s7t44vh8rt9mg",
    "video_attachment_id": "tca_01krdgeqcxet5s7t44vh8rt9mg"
  }'

Reactie201

{
  "id": "abs_01krdgeqcxet5s7t44vh8rt9mg",
  "business_account_id": "abz_01krdgeqcxet5s7t44vh8rt9mg",
  "readiness_attachment": {
    "created_at": "2026-05-20T09:14:52Z",
    "updated_at": "2026-05-25T16:42:01Z",
    "id": "tca_01krdgeqcxet5s7t44vh8rt9mg",
    "status": "draft"
  },
  "use_cases_attachment": {
    "created_at": "2026-05-20T09:14:52Z",
    "updated_at": "2026-05-25T16:42:01Z",
    "id": "tca_01krdgeqcxet5s7t44vh8rt9mg",
    "status": "draft"
  },
  "video_attachment": {
    "created_at": "2026-05-20T09:14:52Z",
    "updated_at": "2026-05-25T16:42:01Z",
    "id": "tca_01krdgeqcxet5s7t44vh8rt9mg",
    "status": "draft"
  },
  "status": "submitted",
  "next": [
    {
      "kind": "operation"
    }
  ]
}

Submits an account for review, making its name, Apple UUID and three uploaded evidence attachments available to Bird staff. This does not approve the account.

Parameters

business_account_idstring

Verzoekpayload

readiness_attachment_id

string

verplicht

Uploaded PDF attachment containing the business readiness assessment.

use_cases_attachment_id

string

verplicht

Uploaded PDF attachment describing the proposed customer use cases.

video_attachment_id

string

verplicht

Uploaded MP4 attachment demonstrating the customer experience.

Response Payload

id

string

verplicht

business_account_id

string

verplicht

apple_business_id

string

verplicht

The Apple business UUID frozen when this attempt was submitted.

name

string

verplicht

The customer-supplied Bird account name frozen when this attempt was submitted.

readiness_attachment

object

verplicht

Onderliggende attributen tonen

readiness_attachment.created_at

string

verplicht

readiness_attachment.updated_at

string

verplicht

readiness_attachment.id

string

verplicht

readiness_attachment.filename

string

verplicht

The uploaded file's name.

readiness_attachment.content_type

string

verplicht

The file's content type, determined from its contents.

readiness_attachment.size_bytes

integer

verplicht

The file's size in bytes.

readiness_attachment.description

string

A short note describing what the file shows.

readiness_attachment.status

string

verplicht

Lifecycle of an attachment. draft is a file that has been uploaded but nothing has been registered or submitted with it yet, and it is discarded at its expires_at. attached means at least one registration has cited it, so it is kept permanently and can no longer be deleted.

Possible values: draft, attached

readiness_attachment.download_url

string

verplicht

Short-lived signed URL for downloading or previewing the attachment. Valid for 24 hours from when the resource was fetched; request a fresh resource to obtain a new URL after expiry. Do not cache beyond download_url_expires_at. Registration authorities (10DLC and toll-free carriers) retrieve evidence via a separate, longer-lived token; this URL is not that token.

readiness_attachment.preview_url

string

Optional signed URL for inline viewing on an isolated storage origin. Valid for one hour; fetch the attachment again to refresh it.

readiness_attachment.download_url_expires_at

string

verplicht

When download_url expires. Both fields are always present; the server returns an error rather than omitting them.

readiness_attachment.expires_at

nullable string

verplicht

When this attachment is discarded if nothing is registered or submitted with it. Null once its status is attached.

use_cases_attachment

object

verplicht

Onderliggende attributen tonen

video_attachment

object

verplicht

Onderliggende attributen tonen

status

string

verplicht

The review outcome of this attempt. Earlier attempts retain their outcome when a new attempt is submitted.

status_reason

nullable string

verplicht

Review feedback on this attempt, such as the reason Apple rejected it. May contain basic Markdown, such as emphasis and lists.

created_at

string

verplicht

next

array of object

Read the parent business account for current eligibility and next actions. Present on create responses and each customer submission-list item; historical attempts do not establish current account state.

Onderliggende attributen tonen

updated_at

string

verplicht

Ga verder met de documentatie, handleidingen en voorbeelden voor dit onderwerp.

Ontvang een implementatieoverzicht

const result = await bird.amb.businessAccounts.submissions.create(
  "abz_01krdgeqcxet5s7t44vh8rt9mg",
  {
    readiness_attachment_id: "tca_01krdgeqcxet5s7t44vh8rt9mg",
    use_cases_attachment_id: "tca_01krdgeqcxet5s7t44vh8rt9mh",
    video_attachment_id: "tca_01krdgeqcxet5s7t44vh8rt9mj",
  },
);
console.log(result);

result = client.amb.business_accounts.submissions.create(
    'abz_01krdgeqcxet5s7t44vh8rt9mg',
    readiness_attachment_id='tca_01krdgeqcxet5s7t44vh8rt9mg',
    use_cases_attachment_id='tca_01krdgeqcxet5s7t44vh8rt9mh',
    video_attachment_id='tca_01krdgeqcxet5s7t44vh8rt9mj',
)
print(result)

result, err := client.Amb.BusinessAccounts.Submissions.Create(ctx, "abz_01krdgeqcxet5s7t44vh8rt9mg", bird.AmbBusinessAccountsSubmissionsCreateParams{
	ReadinessAttachmentID: "tca_01krdgeqcxet5s7t44vh8rt9mg",
	UseCasesAttachmentID:  "tca_01krdgeqcxet5s7t44vh8rt9mh",
	VideoAttachmentID:     "tca_01krdgeqcxet5s7t44vh8rt9mj",
})
if err != nil {
	log.Fatal(err)
}
fmt.Println(result)

$bird->amb->businessAccounts->submissions->create(
    'abz_01krdgeqcxet5s7t44vh8rt9mg',
    (new Model\AMBBusinessAccountSubmissionCreate())
        ->setReadinessAttachmentId('tca_01krdgeqcxet5s7t44vh8rt9mg')
        ->setUseCasesAttachmentId('tca_01krdgeqcxet5s7t44vh8rt9mh')
        ->setVideoAttachmentId('tca_01krdgeqcxet5s7t44vh8rt9mj'),
);

bird amb business-accounts submissions create <business-account-id> \
  --readiness-attachment-id tca_01krdgeqcxet5s7t44vh8rt9mg \
  --use-cases-attachment-id tca_01krdgeqcxet5s7t44vh8rt9mg \
  --video-attachment-id tca_01krdgeqcxet5s7t44vh8rt9mg

curl -X POST "https://us1.platform.bird.com/v1/amb/business-accounts/{business_account_id}/submissions" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "readiness_attachment_id": "tca_01krdgeqcxet5s7t44vh8rt9mg",
    "use_cases_attachment_id": "tca_01krdgeqcxet5s7t44vh8rt9mg",
    "video_attachment_id": "tca_01krdgeqcxet5s7t44vh8rt9mg"
  }'

Reactie201

{
  "id": "abs_01krdgeqcxet5s7t44vh8rt9mg",
  "business_account_id": "abz_01krdgeqcxet5s7t44vh8rt9mg",
  "readiness_attachment": {
    "created_at": "2026-05-20T09:14:52Z",
    "updated_at": "2026-05-25T16:42:01Z",
    "id": "tca_01krdgeqcxet5s7t44vh8rt9mg",
    "status": "draft"
  },
  "use_cases_attachment": {
    "created_at": "2026-05-20T09:14:52Z",
    "updated_at": "2026-05-25T16:42:01Z",
    "id": "tca_01krdgeqcxet5s7t44vh8rt9mg",
    "status": "draft"
  },
  "video_attachment": {
    "created_at": "2026-05-20T09:14:52Z",
    "updated_at": "2026-05-25T16:42:01Z",
    "id": "tca_01krdgeqcxet5s7t44vh8rt9mg",
    "status": "draft"
  },
  "status": "submitted",
  "next": [
    {
      "kind": "operation"
    }
  ]
}

Submit an Apple Messages for Business business for review

Parameters

Verzoekpayload

Response Payload

Gerelateerde bronnen