# `smallforce ads connections connect`

Create or reuse a Meta Ads connection

This page is generated from the same Commander definition shipped in SmallForce CLI 0.1.7. Run `smallforce ads connections connect --help` locally to view the same reference for your installed version.

## Complete command help

```text
Usage: smallforce ads connections connect [options]

Create or reuse a Meta Ads connection

Options:
  --profile <profileId>       Social profile id from social profiles list
  --via <platform>            Parent platform: facebook or instagram (default: "facebook")
  --provider-account <actId>  Limit provider sync to one act_<digits> account; repeatable (default:
                              [])
  --redirect-url <url>        Browser destination after authorization
  --headless                  Request a headless provider authorization flow
  --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
  -h, --help                  display help for command
```

## Related reference

- [`smallforce ads connections`](/docs/cli/commands/ads/connections): 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.