Create an eSIM subscriber

POST

/v1/esim/subscribers

bird esim subscribers create --contact-id con_01krdgeqcxet5s7t44vh8rt9mg

curl -X POST "https://us1.platform.bird.com/v1/esim/subscribers" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "contact_id": "con_01krdgeqcxet5s7t44vh8rt9mg"
  }'

响应200

{
  "id": "esub_01krdgeqcxet5s7t44vh8rt9mg",
  "contact_id": "con_01krdgeqcxet5s7t44vh8rt9mg",
  "created_at": "2026-05-20T09:14:52Z",
  "updated_at": "2026-05-25T16:42:01Z"
}

Creates or returns the subscriber associated with a contact in this workspace. A subscriber identifies the person using the service. This request does not buy an eSIM, assign a profile, or grant workspace access. It requires email_marketing:read and esim:write.

Creating this association prevents deletion of the contact, including after the assigned eSIM ends. Subscriber associations cannot currently be removed, detached, or anonymized. Releasing an eSIM does not restore contact deletion.

请求载荷

contact_id

string

必填

Existing contact in this workspace; requires Contacts read permission.

响应载荷

id

string

必填

contact_id

string

必填

created_at

string

必填

updated_at

string

必填

继续查看此主题的文档、指南和示例。

获取实施简报

bird esim subscribers create --contact-id con_01krdgeqcxet5s7t44vh8rt9mg

curl -X POST "https://us1.platform.bird.com/v1/esim/subscribers" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "contact_id": "con_01krdgeqcxet5s7t44vh8rt9mg"
  }'

响应200

{
  "id": "esub_01krdgeqcxet5s7t44vh8rt9mg",
  "contact_id": "con_01krdgeqcxet5s7t44vh8rt9mg",
  "created_at": "2026-05-20T09:14:52Z",
  "updated_at": "2026-05-25T16:42:01Z"
}

Create an eSIM subscriber

请求载荷

响应载荷

相关资源