Create an Apple Messages for Business record
/v1/amb/business-accountsconst result = await bird.amb.businessAccounts.create({
name: "Acme Retail",
apple_business_id: "b52d6267-2b62-4f8a-8842-0533d0f1dc07",
});
console.log(result);result = client.amb.business_accounts.create(name='Acme Retail', apple_business_id='b52d6267-2b62-4f8a-8842-0533d0f1dc07')
print(result)result, err := client.Amb.BusinessAccounts.Create(ctx, bird.AmbBusinessAccountsCreateParams{Name: "Acme Retail", AppleBusinessID: bird.Ptr("b52d6267-2b62-4f8a-8842-0533d0f1dc07")})
if err != nil {
log.Fatal(err)
}
fmt.Println(result)$bird->amb->businessAccounts->create((new Model\AMBBusinessAccountCreate())->setName('Acme Retail')->setAppleBusinessId('b52d6267-2b62-4f8a-8842-0533d0f1dc07'));bird amb business-accounts create --name 'Acme Retail'curl -X POST "https://us1.platform.bird.com/v1/amb/business-accounts" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"name": "Acme Retail"
}'{
"id": "abz_01krdgeqcxet5s7t44vh8rt9mg",
"apple_business_id": "b52d6267-2b62-4f8a-8842-0533d0f1dc07",
"name": "Acme Retail",
"status": "active",
"invitations_enabled": false,
"created_at": "2026-08-20T09:14:52Z",
"updated_at": "2026-08-25T16:42:01Z",
"next": [
{
"kind": "operation"
}
],
"account_review_status": "approved"
}
Creates an Apple Messages for Business record in your workspace. Each Apple Business ID can belong to only one retained business record in this region. Disconnecting an account does not release its identifier.
The account starts with status: pending and no account_review_status,
including when you supply apple_business_id. Upload the required evidence
and create a submission to begin review. The account remains pending until
approved; its submission records review progress.
Corpo da requisição
nameThe brand name shown for this business record inside Bird.
apple_business_idThe Business ID Apple issued for this brand, if you already have it. Supplying it identifies the draft. Submit the completed evidence requirements explicitly when the business is ready for review.
Payload de resposta
idUnique identifier for the business record.
apple_business_idApple business UUID, or null until supplied. Adding this identifier does not submit the account for review.
nameCustomer-supplied account name used in Bird. Apple controls the name shown to customers in Messages.
statusOperational state of the business account.
Possible values: pending, active, suspended, disconnected
status_reasonReason for the current operational suspension, when recorded. Review feedback is retained on the submission. May contain basic Markdown, such as emphasis and lists.
invitations_enabledWhether Apple has granted invitation access. Sending also requires a configured, connected account and eligible recipient.
created_atWhen the business record was created.
updated_atWhen the business record was last changed.
nextNext setup actions on create, update and single-account reads. Active accounts return an empty array. Lists omit this field.
account_review_statusLatest recorded review outcome. Absent before the first submission.
Possible values (may grow over time): pending, approved, rejected
finish_setup_urlBird dashboard URL for completing setup. Present only when customer action is available.
Recursos relacionados
Continue com a documentação, guias e exemplos sobre este tópico.