Create an eSIM subscriber
POST
/v1/esim/subscribersbird esim subscribers create --contact-id con_01krdgeqcxet5s7t44vh8rt9mgcurl -X POST "https://us1.platform.bird.com/v1/esim/subscribers" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"contact_id": "con_01krdgeqcxet5s7t44vh8rt9mg"
}'Odpowiedź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.
Treść żądania
contact_idstring
wymagane
Existing contact in this workspace; requires Contacts read permission.
Treść odpowiedzi
idstring
wymagane
contact_idstring
wymagane
created_atstring
wymagane
updated_atstring
wymagane
Powiązane zasoby
Przejdź do dokumentacji, przewodników i przykładów dotyczących tego tematu.