送信ID の作成

このエンドポイントを使用して、メッセージの送信に使用できる送信ID を作成し、送信ごとにキャンペーンを作成せずにプログラムでメッセージパフォーマンスを追跡します。

メッセージの追跡と送信に送信識別子を使用すると、プログラムでコンテンツを生成および送信する場合に便利です。

前提条件

このエンドポイントを使用するには、sends.id.create 権限を持つAPI キーを生成する必要があります。

レート制限

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.

リクエスト本文

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
}

要求パラメータ

リクエスト例

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

レスポンス

成功応答の例

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