Créer des ID d’envoi

Utilisez cet endpoint pour créer des ID d’envoi pouvant être utilisés pour envoyer des messages et suivre leur performance de manière programmatique sans créer de campagne pour chaque envoi.

L’utilisation de l’identifiant d’envoi pour suivre et envoyer des messages est utile si vous prévoyez de générer et d’envoyer du contenu via un programme.

Conditions préalables

Pour utiliser cet endpoint, vous devrez générer une clé API avec l’autorisation sends.id.create.

Limite de débit

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.

Corps de la demande

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
}

Paramètres de demande

Exemple de demande

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

Réponse

Exemple de réponse réussie

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