Submit an Apple Messages for Business business for review
/v1/amb/business-accounts/{business_account_id}/submissionsconst 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_01krdgeqcxet5s7t44vh8rt9mgcurl -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"
}'{
"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_idstringRequest Payload
readiness_attachment_idUploaded PDF attachment containing the business readiness assessment.
use_cases_attachment_idUploaded PDF attachment describing the proposed customer use cases.
video_attachment_idUploaded MP4 attachment demonstrating the customer experience.
Response Payload
idbusiness_account_idapple_business_idThe Apple business UUID frozen when this attempt was submitted.
nameThe customer-supplied Bird account name frozen when this attempt was submitted.
readiness_attachmentA supporting document uploaded for compliance answers or SMS registrations, including number ownership evidence, 10DLC campaign evidence and toll-free verification opt-in screenshots. Reference its ID from the relevant answer or registration attachment field to submit it as evidence.
use_cases_attachmentA supporting document uploaded for compliance answers or SMS registrations, including number ownership evidence, 10DLC campaign evidence and toll-free verification opt-in screenshots. Reference its ID from the relevant answer or registration attachment field to submit it as evidence.
video_attachmentA supporting document uploaded for compliance answers or SMS registrations, including number ownership evidence, 10DLC campaign evidence and toll-free verification opt-in screenshots. Reference its ID from the relevant answer or registration attachment field to submit it as evidence.
statusThe review outcome of this attempt. Earlier attempts retain their outcome when a new attempt is submitted.
Possible values: submitted, in_review, approved, rejected
status_reasonReview feedback on this attempt, such as the reason Apple rejected it. May contain basic Markdown, such as emphasis and lists.
created_atnextRead 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.
updated_atRelated resources
Continue with the documentation, guides and examples for this topic.