Sende-IDs erstellen

Verwenden Sie diesen Endpunkt, um Sende-IDs zu erstellen, die zum programmgesteuerten Senden von Nachrichten und zum Tracking der Nachrichten-Performance verwendet werden können, ohne dass für jeden Sendevorgang eine Campaign erstellt werden muss.

Die Verwendung des Sende-Bezeichners zum Tracking und Versenden von Nachrichten ist nützlich, wenn Sie planen, Inhalte programmatisch zu erstellen und zu versenden.

Voraussetzungen

Um diesen Endpunkt zu verwenden, müssen Sie einen API-Schlüssel mit der Berechtigung sends.id.create generieren.

Rate-Limit

Sie können über diesen Endpunkt pro Tag bis zu 100 benutzerdefinierte Sende-Bezeichner für einen bestimmten Workspace erstellen. Jede send_id- und campaign_id-Kombination, die Sie erstellen, wird auf Ihr Tageslimit angerechnet. Die Antwort-Header für jede gültige Anfrage enthalten den aktuellen Status der Rate-Limits. Weitere Informationen finden Sie unter API-Rate-Limits.

Anfragetext

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
}

Anfrageparameter

Beispielanfrage

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

Antwort

Beispiel für eine erfolgreiche Antwort

1
2
3
4
{
  "message": "success",
  "send_id" : (string) the send identifier
}