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

O número máximo diário de identificadores de envio personalizados que podem ser criados por meio desse endpoint é 100 para um determinado espaço de trabalho. Cada combinação de send_id e campaign_id que você criar contará para o seu limite diário. Os cabeçalhos de resposta de qualquer solicitação válida incluem o status do limite de frequência atual; consulte Limites de frequência da API para obter detalhes.

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
}