Apple Messages for Business API

Light-mode Apple Messages business invitation with Yes and No

Business invitations

Most Apple Messages for Business conversations start when the customer taps Message. A business invitation is the sanctioned way for the brand to open the thread: an Apple-managed template, with Yes and No, sent only after the customer has opted in.

curl -X POST https://api.blooio.com/v4/messages \
  -H "Authorization: Bearer bl_live_..." \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "from": "your-amb-alias",
    "to": "+15551234567",
    "invitation": {
      "template_id": "binaryChoice.engage.withImage",
      "reference_id": "case-1009273616",
      "parameters": {
        "brandName": "Your Brand",
        "brandLogo": "<base64-png>"
      },
      "locale": "en-us"
    }
  }'

Read the docs

Light-mode Apple Messages list picker with Haircut and Color

List pickers

A list picker is one or more sections of rows. The customer picks a service, a product, or an option inside Apple Messages for Business. Set multipleSelection when a section should allow more than one row.

{
  "from": "support",
  "to": "opaque-amb-customer-id",
  "interactive": {
    "kind": "list_picker",
    "received_message": { "title": "Choose a service", "style": "small" },
    "reply_message": { "title": "Thanks — booking you in", "style": "small" },
    "sections": [
      {
        "title": "Services",
        "multipleSelection": false,
        "items": [
          { "identifier": "haircut", "title": "Haircut", "subtitle": "30 min" },
          { "identifier": "color", "title": "Color", "subtitle": "90 min" }
        ]
      }
    ]
  }
}

Read the docs

Quick replies

Quick replies are a short prompt and up to five taps. Send a text bubble first, then the quick reply. Apple Messages for Business rejects a quick reply that also includes a received message bubble.

curl -X POST https://api.blooio.com/v4/messages \
  -H "Authorization: Bearer bl_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "from": "support",
    "to": "opaque-amb-customer-id",
    "interactive": {
      "kind": "quick_reply",
      "summary_text": "How can we help?",
      "items": [
        { "id": "sales", "title": "Talk to sales" },
        { "id": "support", "title": "Get support" },
        { "id": "hours", "title": "Store hours" }
      ]
    }
    }'

Read the docs

Light-mode Apple Messages time picker for a consultation on July 20

Time pickers

The customer picks a time in Apple Messages for Business. The card shows the day, and the open slots are behind it.

{
  "kind": "time_picker",
  "received_message": { "title": "Pick a time for your consultation" },
  "event": {
    "title": "Consultation",
    "location": { "title": "Main St" },
    "timeslots": [
      { "startTime": "2026-07-20T17:00:00Z", "duration": 3600 },
      { "startTime": "2026-07-20T18:00:00Z", "duration": 3600 }
    ]
  }
}

Read the docs

Apple Pay

The customer pays inside the conversation. The amount and Apple Pay stay in the thread.

{
  "kind": "apple_pay",
  "payment": {
    "paymentRequest": {
      "total": { "label": "Order", "amount": "10.00" },
      "currencyCode": "USD",
      "countryCode": "US"
    }
  }
}

Read the docs

Light-mode Apple Messages form card to book an appointment

Forms

A form starts as a card in the thread. The customer taps it and fills the pages without leaving Apple Messages for Business.

{
  "kind": "form",
  "received_message": { "title": "Book an appointment" },
  "dynamic": {
    "version": "1.0",
    "startPageIdentifier": "details",
    "pages": [
      {
        "pageIdentifier": "details",
        "title": "Your details",
        "textInputs": [
          { "identifier": "name", "title": "Full name", "type": "name" }
        ]
      }
    ]
  }
}

Read the docs

Go from setup to a reviewed customer journey.

Apple Messages for Business goes live after brand verification, testing, and Apple's Experience Review. We walk you through each step.

Talk to us

Step 1

Step 2

Step 3

Prepare your brand profile for verification in the Apple Business Register.

Connect & test

Connect your CRM, backend, API, and workflows, then test the experience before customers see it.

Review

Apple completes a formal Experience Review before the journey goes live.

Prepare your brand profile for verification in the Apple Business Register.

Connect & test

Connect your CRM, backend, API, and workflows, then test the experience before customers see it.

Review

Apple completes a formal Experience Review before the journey goes live.

API questions

What Apple Messages for Business is, and how it is priced, stays on the homepage FAQ.

What is the Apple Messages for Business API?

It is how a brand connects to Apple Messages for Business through Blooio. Blooio is a Messaging Service Provider: the platform, business invitations, list pickers, quick replies, Apple Pay, forms, and live agent handoff.

What is a business invitation?

A business invitation is an Apple-managed template that asks the customer to connect in Apple Messages for Business. It requires Apple's approval for invitations and an explicit opt-in. The customer sees Yes and No.

What is a list picker?

A list picker is a set of rows, grouped in sections, that the customer taps inside the conversation. Each row has an identifier and a title. The reply comes back with the rows they chose.

What are quick replies?

Quick replies are one to five tappable options under a prompt. Send the prompt as text, then the quick reply. The customer's tap comes back with the option id and title.

Does the Apple Messages for Business API support Apple Pay?

Yes. Customers can complete an eligible purchase with Apple Pay inside the conversation, along with list pickers, time pickers, quick replies, forms, authentication, and rich links.

How does a brand go live?

Launch follows brand verification, sandbox testing, and Apple's Experience Review. Blooio walks you through each step. It is not an instant self-serve signup.

Empower your team. Achieve more.

Apple Messages for Business launches after brand verification, testing, and Apple's Experience Review. Talk to us and we'll scope the journey.

Talk to us

Business invitations

curl -X POST https://api.blooio.com/v4/messages \
  -H "Authorization: Bearer bl_live_..." \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "from": "your-amb-alias",
    "to": "+15551234567",
    "invitation": {
      "template_id": "binaryChoice.engage.withImage",
      "reference_id": "case-1009273616",
      "parameters": {
        "brandName": "Your Brand",
        "brandLogo": "<base64-png>"
      },
      "locale": "en-us"
    }
  }'

Read the docs

List pickers

{
  "from": "support",
  "to": "opaque-amb-customer-id",
  "interactive": {
    "kind": "list_picker",
    "received_message": { "title": "Choose a service", "style": "small" },
    "reply_message": { "title": "Thanks — booking you in", "style": "small" },
    "sections": [
      {
        "title": "Services",
        "multipleSelection": false,
        "items": [
          { "identifier": "haircut", "title": "Haircut", "subtitle": "30 min" },
          { "identifier": "color", "title": "Color", "subtitle": "90 min" }
        ]
      }
    ]
  }
}

Read the docs

Quick replies

Quick replies are a short prompt and up to five taps. Send a text bubble first, then the quick reply. Apple Messages for Business rejects a quick reply that also includes a received message bubble.

curl -X POST https://api.blooio.com/v4/messages \
  -H "Authorization: Bearer bl_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "from": "support",
    "to": "opaque-amb-customer-id",
    "interactive": {
      "kind": "quick_reply",
      "summary_text": "How can we help?",
      "items": [
        { "id": "sales", "title": "Talk to sales" },
        { "id": "support", "title": "Get support" },
        { "id": "hours", "title": "Store hours" }
      ]
    }
    }'

Read the docs

Time pickers

The customer picks a time in Apple Messages for Business. The card shows the day, and the open slots are behind it.

{
  "kind": "time_picker",
  "received_message": { "title": "Pick a time for your consultation" },
  "event": {
    "title": "Consultation",
    "location": { "title": "Main St" },
    "timeslots": [
      { "startTime": "2026-07-20T17:00:00Z", "duration": 3600 },
      { "startTime": "2026-07-20T18:00:00Z", "duration": 3600 }
    ]
  }
}

Read the docs

Apple Pay

The customer pays inside the conversation. The amount and Apple Pay stay in the thread.

{
  "kind": "apple_pay",
  "payment": {
    "paymentRequest": {
      "total": { "label": "Order", "amount": "10.00" },
      "currencyCode": "USD",
      "countryCode": "US"
    }
  }
}

Read the docs

Forms

A form starts as a card in the thread. The customer taps it and fills the pages without leaving Apple Messages for Business.

{
  "kind": "form",
  "received_message": { "title": "Book an appointment" },
  "dynamic": {
    "version": "1.0",
    "startPageIdentifier": "details",
    "pages": [
      {
        "pageIdentifier": "details",
        "title": "Your details",
        "textInputs": [
          { "identifier": "name", "title": "Full name", "type": "name" }
        ]
      }
    ]
  }
}

Read the docs

Go from setup to a reviewed customer journey.

Apple Messages for Business goes live after brand verification, testing, and Apple's Experience Review. We walk you through each step.

Talk to us

Step 1

Step 2

Step 3

Prepare your brand profile for verification in the Apple Business Register.

Connect & test

Connect your CRM, backend, API, and workflows, then test the experience before customers see it.

Review

Apple completes a formal Experience Review before the journey goes live.

Prepare your brand profile for verification in the Apple Business Register.

Connect & test

Connect your CRM, backend, API, and workflows, then test the experience before customers see it.

Review

Apple completes a formal Experience Review before the journey goes live.

API questions

What Apple Messages for Business is, and how it is priced, stays on the homepage FAQ.

What is the Apple Messages for Business API?

What is a business invitation?

What is a list picker?

A list picker is a set of rows, grouped in sections, that the customer taps inside the conversation. Each row has an identifier and a title. The reply comes back with the rows they chose.

What are quick replies?

Quick replies are one to five tappable options under a prompt. Send the prompt as text, then the quick reply. The customer's tap comes back with the option id and title.

Does the Apple Messages for Business API support Apple Pay?

Yes. Customers can complete an eligible purchase with Apple Pay inside the conversation, along with list pickers, time pickers, quick replies, forms, authentication, and rich links.

How does a brand go live?

Launch follows brand verification, sandbox testing, and Apple's Experience Review. Blooio walks you through each step. It is not an instant self-serve signup.

Empower your team. Achieve more.

Apple Messages for Business launches after brand verification, testing, and Apple's Experience Review. Talk to us and we'll scope the journey.

Talk to us