Send Apple Events Early access

Send one or more events to multiple recipients.

Please log in to see full path URL. Learn why.
post
/apple-mfb/1/events
Request Body schema:
application/json
collapse all -
events
required
Array of objects

An array of event objects of the events to be sent.

Array
content
object

Event content.

type
required
string
typingIndicatorType
required
string
Enum: "TYPING_START" "TYPING_END"

Type of the indicator being sent

options
object

Event options.

platform
object

Platform options. For more details, see documentation.

entityId
string [ 0 .. 255 ] characters

Used when specifying an entity in outbound send requests. It is also returned in notification events. For detailed usage, refer to the documentation.

applicationId
string [ 0 .. 255 ] characters

Used when specifying an application in outbound send requests. It is also returned in notification events. For detailed usage, refer to the documentation.

validityPeriod
object

Message validity period. Once expired, the message won't be sent. Validity period longer than 48h is not supported. If exceeded, it will be automatically set to 48h.

amount
required
integer <int32>

Message validity period's value. If timeUnit is not set, it will default to MINUTES.

timeUnit
string
Default: "MINUTES"
Enum: "SECONDS" "MINUTES" "HOURS"

Message validity period time unit.

sender
required
string

The sender ID. It can be alphanumeric or numeric (e.g., CompanyName). Make sure you don't exceed character limit.

destinations
required
Array of objects

An array of destination objects for where the event is being sent. A valid destination is required.

Array
to
required
string

The destination address of the message.

messageId
string [ 0 .. 200 ] characters

The ID that uniquely identifies the message sent.

options
object

Options applicable to all events in the request.

schedule
object

Options for scheduling a message.

bulkId
string [ 0 .. 100 ] characters

Unique ID assigned to the request if messaging multiple recipients or sending multiple messages via a single API request. If not provided, it will be auto-generated and returned in the API response.

sendAt
string <date-time>

Date and time when the message is to be sent. Used for scheduled messages. Has the following format: yyyy-MM-dd'T'HH:mm:ss.SSSZ, and can only be scheduled for no later than 180 days in advance.

sendingSpeedLimit
object

Limits the send speed when sending messages in bulk to deliver messages over a longer period of time. You may wish to use this to allow your systems or agents to handle large amounts of incoming traffic, e.g., if you are expecting recipients to follow through with a call-to-action option from a message you sent. Not setting a send speed limit can overwhelm your resources with incoming traffic.

amount
required
integer <int32>

The number of messages to be sent per timeUnit. By default, the system sends messages as fast as the infrastructure allows. Use this parameter to adapt sending capacity to your needs. The system is only able to work against its maximum capacity for ambitious message batches.

timeUnit
string
Default: "MINUTE"
Enum: "MINUTE" "HOUR" "DAY"

The time unit to define when setting a messaging speed limit. Defaults to MINUTE.

Responses

200

OK

400

Bad Request

401

Unauthorized

403

Forbidden

500

Internal Server Error

Request samples

Content type
application/json
Copy
Collapse all
{
  • "events":
    [
    • {
      • "content":
        {
        • "typingIndicatorType": "TYPING_START",
        • "type": "TYPING_INDICATOR"
        },
      • "sender": "a42fa0e0-1d5f-44f6-a321-0e40300f7712",
      • "destinations":
        [
        • {
          • "to": "urn:mbid:AQAAY9Jnpv/q1IF4WbOLgbiYgFXChjL7cr/rXgVCLG5fZbaG5izE6Wh/U6Hkh0bdBtXHijppErU/Pc2m1R+ZChHIHbgEVFY9bIGIrNrZuUZxdv6IPPoCc1h3bHaqQpJVmA336yywH/vqxBZwQoT7YMETabM+8es="
          }
        ]
      }
    ]
}

Response samples

Content type
application/json
Copy
Collapse all
{
  • "bulkId": "1688025180464000013",
  • "messages":
    [
    • {
      • "messageId": "1688025180464000014",
      • "status":
        {
        • "groupId": 1,
        • "groupName": "PENDING",
        • "id": 26,
        • "name": "PENDING_ACCEPTED",
        • "description": "Message sent to next instance"
        },
      • "destination": "urn:mbid:AQAAY9Jnpv/q1IF4WbOLgbiYgFXChjL7cr/rXgVCLG5fZbaG5izE6Wh/U6Hkh0bdBtXHijppErU/Pc2m1R+ZChHIHbgEVFY9bIGIrNrZuUZxdv6IPPoCc1h3bHaqQpJVmA336yywH/vqxBZwQoT7YMETabM+8es="
      }
    ]
}

Encountering issues

Contact our support

What's new? Check out

Release Notes

Unsure about a term? See

Glossary

Research panel

Help shape the future of our products
Learn more
Service status

Copyright @ 2006-2025 Infobip ltd.