---
title: "bird esim credentials deliver"
description: "Send install credentials to the traveler"
canonical: "https://bird.com/docs/cli/reference/esim-credentials-deliver"
---

# `bird esim credentials deliver`

## Usage

```bash
bird esim credentials deliver <esim-id> [flags]
```

## Description

Send install credentials to the traveler

Send an eSIM's install credentials to the traveler by email or SMS, in English. Use after purchase or to resend installation details.

Build the request from flags, a JSON EsimDelivery body via --body-file ("-" reads
stdin), or both — a flag overrides the matching body field. Run --example to
print a ready-to-edit body, or --dry-run to print the resolved request without
sending it.

## Procedure

Step 8 of 8 of "Buy and install an eSIM data package". Previous: bird esim credentials get.

## Examples

```bash
# print the body shape (no credentials needed)
bird esim credentials deliver --example

# the body it prints:
```

```json
{
  "channel": "sms",
  "locale": "nl",
  "to": "+31612345678"
}
```

## Options

#### Request

| Name                | Description                                                  |
| ------------------- | ------------------------------------------------------------ |
| `--body-file`       | Read the JSON request body from this file; "-" reads stdin   |
| `--example`         | Print a complete example request body, then exit             |
| `--dry-run`         | Print the resolved request without sending it, then exit     |
| `--idempotency-key` | Deduplication key; a retry with the same key won't act twice |

#### Options

| Name                | Description                                                                                                                         |
| ------------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| `--to`              | Recipient address. An email address for the email channel, an E.164 phone number for the sms channel. (required; or in --body-file) |
| `--channel`         | Channel the install credentials are delivered over. Possible values: email, sms. (required; or in --body-file)                      |
| `--locale`          | Language for the message. Falls back to the closest available language, then English.                                               |
| `--response-schema` | Print the fields this command returns, then exit                                                                                    |

## Related

| Name                                                                    | Description                  |
| ----------------------------------------------------------------------- | ---------------------------- |
| [`bird esim credentials get`](/docs/cli/reference/esim-credentials-get) | Get eSIM install credentials |

## Related resources

- [Should I use a Bird SDK or call the API directly?](/explained/platform/should-i-use-an-sdk-or-call-the-api-directly) (answer)
- [Build your first integration](/learn/paths/integration) (course)
- [Send your first email](/docs/get-started/send-your-first-email) (docs)

[Get an implementation brief](/learn/workspace?topic=api-basics)