# `smallforce calls links create`

Create a personal call link; reuse the idempotency key and input for retries

This page is generated from the same Commander definition shipped in SmallForce CLI 0.1.8. Run `smallforce calls links create --help` locally to view the same reference for your installed version.

## Complete command help

```text
Usage: smallforce calls links create [options]

Create a personal call link; reuse the idempotency key and input for retries

Options:
  --api-key <key>                   SmallForce API key, or set SMALLFORCE_API_KEY
  --backend-url <url>               SmallForce backend URL, or set SMALLFORCE_BACKEND_URL
  --json                            Print stable machine-readable JSON
  --text                            Print human-readable text
  --format <format>                 Output format: text or json
  --input <json>                    Full settings as a JSON object; explicit flags take precedence
  --input-file <path>               Read settings JSON from a file, or - for stdin
  --assistant-id <id>               Configured regular assistant
  --title <title>                   Call title
  --recipient-name <name>           Recipient display name
  --recipient-email <email>         Email used for optional verification
  --customer-reference <reference>  Your customer identifier
  --context <content>               Private background for this conversation
  --context-file <path>             Read private context from a file, or - for stdin
  --modes <modes...>                Allowed call modes (choices: "audio", "video")
  --expires-at <timestamp>          ISO timestamp including timezone, within 90 days
  --expires-in <duration>           Relative expiry such as 30m, 12h or 7d
  --verify-email                    Require email verification before the call
  --idempotency-key <key>           Stable key for this creation request (required in flags or JSON)
  -h, --help                        display help for command
```

## Related reference

- [`smallforce calls links`](/docs/cli/commands/calls/links): Parent command and related operations.
- [CLI installation and authentication](/docs/cli/getting-started): Install the CLI and configure an API key.
- [CLI JSON output](/docs/cli/json-output): Use stable machine-readable output in scripts and agents.
