Assign an eSIM to a person
POST
/v1/esim/sims/{esim_id}/assignmentbird esim assignment create <esim-id> \
--subscriber-id esub_01krdgeqcxet5s7t44vh8rt9mgcurl -X POST "https://us1.platform.bird.com/v1/esim/sims/{esim_id}/assignment" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"subscriber_id": "esub_01krdgeqcxet5s7t44vh8rt9mg"
}'Response200
{
"id": "eas_01krdgeqcxet5s7t44vh8rt9mg",
"subscriber_id": "esub_01krdgeqcxet5s7t44vh8rt9mg",
"esim_id": "esm_01krdgeqcxet5s7t44vh8rt9mg",
"created_at": "2026-05-20T09:14:52Z",
"updated_at": "2026-05-25T16:42:01Z"
}
Assigns an existing, allocated eSIM to a subscriber in the same workspace. Unavailable profile states return 409. Identification guidance does not gate assignment; customers handle identification collection and compliance. Repeating the same assignment returns its existing record; assigning a different person returns 409. This does not change paid packages, deliver credentials, or grant access to them.
Parameters
esim_idstringThe esim id.
Request Payload
subscriber_idstring
required
Subscriber in this workspace to assign to the eSIM.
Response Payload
idstring
required
subscriber_idstring
required
esim_idstring
required
created_atstring
required
updated_atstring
required
Related resources
Continue with the documentation, guides and examples for this topic.