Criar IDs de envio

Use esse ponto de extremidade para criar IDs de envio que possam ser usados para enviar mensagens e rastrear o desempenho das mensagens programaticamente, sem a criação de campanhas para cada envio.

Usar o identificador de envio para rastrear e enviar mensagens é útil se estiver planejando gerar e enviar conteúdo programaticamente.

Pré-requisitos

Para usar esse endpoint, você precisará gerar uma chave de API com a permissão sends.id.create.

Limite de taxa

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 toward your daily limit. The response headers for any valid request include the current rate limit status, see API rate limits for details.

Corpo da solicitação

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
}

Parâmetros de solicitação

Exemplo de solicitação

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"
}'

Resposta

Exemplo de resposta bem-sucedida

1
2
3
4
5
6
Content-Type: application/json
Authorization: Bearer YOUR-REST-API-KEY
{
  "message": "success",
  "send_id" : (string) the send identifier
}