> ## Documentation Index
> Fetch the complete documentation index at: https://docs.autocampaign.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect Telnyx

> Connect your Telnyx account and messaging profile to send and receive SMS through Autocampaign AI.

<Info>
  **Time to complete:** \~15–30 minutes to connect and add numbers, plus 1–2 days for
  10DLC carrier approval  ·  **Difficulty:** Beginner
</Info>

## Overview

Telnyx is one of two SMS [providers](/getting-started/glossary#provider) Autocampaign AI
supports (the other is [Twilio](/providers/twilio)). Connecting Telnyx lets
Autocampaign AI send text messages through your Telnyx numbers and messaging
profiles, and receive replies in your [Inbox](/inbox/overview). It also handles
[A2P 10DLC](/compliance/a2p-10dlc) registration (the US carrier registration
required to send business texts from a local number).

<Tip>
  **In short:** 1) Paste a Telnyx API key with Messaging scope. 2) Register your
  10DLC brand and pick a messaging profile. 3) Add numbers and finish setup.
</Tip>

<Note>
  In Telnyx, a **messaging profile** plays the same role that a *messaging service*
  plays in Twilio. Autocampaign AI uses "Messaging Profile" terminology throughout the
  Telnyx setup.
</Note>

<Note>
  Only **one SMS provider can be active at a time** per workspace. If Twilio is
  already connected, connecting Telnyx prompts you to switch — the previous
  provider's numbers and profiles are removed on switch.
</Note>

## Before you start

You need:

* A [Telnyx account](https://telnyx.com) with a phone number, or funds to buy one.
* A Telnyx [**API Key**](/getting-started/glossary#api-key) — a password that lets
  Autocampaign AI use your Telnyx account (Telnyx Portal → **API Keys**). It must
  have **Messaging scope enabled**, meaning the key is allowed to send messages.
* Optionally, a **Messaging Profile ID** (Telnyx Portal → **Messaging → Messaging
  Profiles**) if you want to link an existing profile.
* To be an Owner or Admin in Autocampaign AI, or have an admin give you permission to
  manage channels.

<Warning>
  The API key must have the **Messaging** scope. A key without it connects to
  Telnyx but can't send messages, and Autocampaign AI will reject it when checking it.
</Warning>

## Connect Telnyx

<Steps>
  <Step title="Open the Telnyx channel">
    Go to **Settings → Channels**. Under **SMS**, find the **Telnyx** card
    ("Carrier-grade SMS messaging via Telnyx") and click **Configure**.
  </Step>

  <Step title="Enter your Telnyx details">
    On the **Connect** tab, fill in:

    | Field                    | Required | Where to find it                               | Format            |
    | ------------------------ | -------- | ---------------------------------------------- | ----------------- |
    | **API Key**              | Yes      | Telnyx Portal → API Keys (Messaging scope)     | Starts with `KEY` |
    | **Messaging Profile ID** | No       | Telnyx Portal → Messaging → Messaging Profiles | A UUID            |

    Autocampaign AI checks the format as you type — the API Key must start with `KEY`.
    The Messaging Profile ID (if provided) must be a UUID (a long ID made of
    letters, numbers, and dashes).
  </Step>

  <Step title="Connect & save">
    Click **Connect & Save Credentials**. Autocampaign AI checks the key with Telnyx
    by listing your messaging profiles before saving. On success you'll see
    **"Channel connected successfully"** and the setup wizard opens.
  </Step>
</Steps>

## Finish setup (profile, numbers, 10DLC)

After connecting, the **Set Up Your Channel** wizard runs in the recommended order:

<Steps>
  <Step title="10DLC Brand" icon="shield-check">
    Register the business that will send messages — see [A2P 10DLC](/compliance/a2p-10dlc).
  </Step>

  <Step title="Messaging Profile" icon="gear">
    Select one or more messaging profiles (the groups that hold your numbers), or
    create a new one.
  </Step>

  <Step title="10DLC Campaign" icon="file-lines">
    Register a campaign linked to your profile, or skip to numbers (recommended,
    not required to finish).
  </Step>

  <Step title="Numbers" icon="hashtag">
    Assign numbers to your profile, or **Buy New Number**.
  </Step>
</Steps>

Click **Finish Setup** to save.

### Buy a phone number

From the **Numbers** step, click **Buy New Number** and choose a **Country**.
Optionally filter by **Area Code** or a **Contains** pattern, and select
**Capabilities** (SMS for texts, MMS for pictures, Voice for calls). Then
**Search Numbers** → **Buy** and confirm.

## How replies reach Autocampaign AI (webhooks)

[Webhooks](/getting-started/glossary#webhook) are the addresses Telnyx uses to
send replies and delivery updates to Autocampaign AI. They are set up automatically.
Autocampaign AI sets your messaging profile's webhook URL to
`https://<your-app-domain>/webhooks/sms/telnyx` (with a backup URL for delivery
events). Incoming webhooks are verified with Telnyx's Ed25519 signature
(`telnyx-signature-ed25519` + `telnyx-timestamp`), so only genuine requests from
Telnyx are accepted.

## Check the channel status

The header shows **Active**, **Disconnected**, or **Error**. After connecting, the
Connect tab shows only a masked API Key. Use **Disconnect** to remove the channel
(this makes numbers unusable and pauses campaigns using it).

## FAQ

<AccordionGroup>
  <Accordion title="Do I need a Messaging Profile ID to connect?">
    No — it's optional. If you leave it blank, Autocampaign AI finds your messaging
    profiles using the API key and lets you pick one during setup.
  </Accordion>

  <Accordion title="What scope does my API key need?">
    The **Messaging** scope. Turn it on when creating the key in the Telnyx Portal.
    A key without Messaging scope is rejected when checked.
  </Accordion>

  <Accordion title="What's the difference between a profile and a service?">
    They're the same concept across providers. Telnyx calls it a **messaging
    profile**; Twilio calls it a **messaging service**. Autocampaign AI assigns numbers to
    a profile so it knows which sender and webhooks to use.
  </Accordion>

  <Accordion title="Can I run Telnyx and Twilio together?">
    No. Only one SMS provider is active per workspace at a time.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="'Invalid API key'">
    Telnyx rejected the key. Re-copy it from the Telnyx Portal → API Keys, and make
    sure you're using a full key that starts with `KEY`.
  </Accordion>

  <Accordion title="'API key is missing required permissions'">
    Full message: *"Ensure the key has Messaging scope enabled in the Telnyx
    dashboard."* Edit or recreate the key with the **Messaging** scope, then
    reconnect.
  </Accordion>

  <Accordion title="'Must be a valid Telnyx API key (starts with KEY)'">
    The API Key field must start with `KEY`. You may have pasted a different token
    — copy the API key value, not the key ID or a public key.
  </Accordion>

  <Accordion title="Why don't my numbers receive replies?">
    Finish setup so Autocampaign AI can save its webhook address to your messaging
    profile, and confirm the number is attached to that profile.
  </Accordion>
</AccordionGroup>

<Card title="Next: register for 10DLC" icon="shield-check" href="/compliance/a2p-10dlc">
  Required for reliable US SMS delivery.
</Card>