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

Vous pouvez créer jusqu’à 100 identifiants d’envoi personnalisés par jour à l’aide de cet endpoint pour un espace de travail donné. Chaque combinaison de send_id et campaign_id que vous créez est prise en compte dans votre limite quotidienne. Les en-têtes de réponse pour toute demande valide comprennent l’état actuel de la limite de débit. Voir les limites de débit de l’API pour plus de détails.

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
{
  "message": "success",
  "send_id" : (string) the send identifier
}