Crear ID de envío

Utiliza este punto final para crear ID de envío que puedan utilizarse para enviar mensajes y hacer un seguimiento del rendimiento de los mensajes mediante programación, sin necesidad de crear campañas para cada envío.

Utilizar el identificador de envío para el seguimiento y envío de mensajes es útil si piensas generar y enviar contenido mediante programación.

Requisitos previos

Para utilizar este punto final, deberás generar una clave de API con el permiso sends.id.create.

Límite de velocidad

El número máximo diario de identificadores de envío personalizados que pueden crearse a través de este punto final es de 100 para un espacio de trabajo determinado. Cada combinación de send_id y campaign_id que crees contará para tu límite diario. Los encabezados de respuesta de cualquier solicitud válida incluyen el estado actual del límite de velocidad; para más detalles, consulta los límites de velocidad de la API.

Cuerpo de la solicitud

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 la solicitud

Ejemplo de solicitud

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

Respuesta

Ejemplo de respuesta satisfactoria

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