Skip to content

Create send IDs

post

/sends/id/create

Use this endpoint to create send IDs that can be used to send messages and track message performance programmatically, without campaign creation for each send.

Using the send identifier to track and send messages is useful if you are planning to programmatically generate and send content.

Prerequisites

To use this endpoint, you’ll need to generate an API key with the sends.id.create permission.

Rate limit

The daily maximum number of custom send identifiers that can be created via this endpoint is 100 for a given workspace. Each send_id and campaign_id combination that you create will count towards your daily limit. The response headers for any valid request include the current rate limit status, see API rate limits for details.

Request body

1
2
Content-Type: application/json
Authorization: Bearer YOUR-REST-API-KEY
1
2
3
4
{
  "campaign_id": (required, string) see campaign identifier,
  "send_id": (optional, string) see send identifier
}

Request parameters

Parameter Required Data Type Description
campaign_id Required String See campaign identifier.
send_id Optional String See send identifier.

Example request

1
2
3
4
5
6
7
curl --location --request POST 'https://rest.iad-01.braze.com/sends/id/create' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR-REST-API-KEY' \
--data-raw '{
  "campaign_id": "campaign_identifier",
  "send_id": "send_identifier"
}'

Response

Example success response

1
2
3
4
5
6
Content-Type: application/json
Authorization: Bearer YOUR-REST-API-KEY
{
  "message": "success",
  "send_id" : (string) the send identifier
}
HOW HELPFUL WAS THIS PAGE?
New Stuff!