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

# Carrd

# Carrd Integration Guide

Carrd forms support custom URLs for submissions — they can POST directly to Trackly.

## Method 1: Form with Custom URL (Recommended)

### Step 1: Create your form

1. Add a **Form** element to your Carrd site
2. Add fields:
   * **Phone** (name: `phone`, type: text, required)
   * **Name** (name: `first_name`, type: text)
3. Add a text element below the form with TCPA consent language: "By signing up, you agree to receive SMS marketing messages. Msg & data rates may apply. Reply STOP to unsubscribe."

### Step 2: Configure the form action

1. Select the form element
2. Set **Action** to: `Custom URL`
3. Set the **URL** to:
   ```
   https://api.tracklysms.com/api/v2/optins/webhook
   ```
4. Carrd sends form data as `application/x-www-form-urlencoded` — Trackly accepts this automatically

### Step 3: Limitations

Carrd forms cannot set custom headers (like `X-Api-Key`). For API key authentication, you'll need one of these workarounds:

**Option A: Use the iframe embed instead** (recommended — see Method 2 below)

**Option B: Use a simple redirect proxy** — set up a free Cloudflare Worker or similar that adds your API key header and forwards the request to Trackly's webhook.

### Step 4: Hidden fields

Add hidden fields to include required data:

* `list_id`: your Trackly sending list ID
* `consent_text`: your TCPA consent language

## Method 2: Iframe Embed (Recommended for Carrd)

Since Carrd forms can't set custom headers, the iframe embed is the easiest approach:

1. Add a **Widget / Embed** element to your site
2. Set **Type** to `Code`
3. Paste:
   ```html theme={null}
   <iframe src="https://api.tracklysms.com/optin/page/YOUR_PUBLIC_TOKEN" width="100%" height="520" frameborder="0" style="border:none;max-width:480px;margin:0 auto;display:block;"></iframe>
   ```
4. Replace `YOUR_PUBLIC_TOKEN` with your opt-in configuration's public token

## Method 3: Subscribe Link

Since Carrd is often used for simple landing pages, a direct link works well:

1. Add a **Button** element
2. Set the URL to: `https://api.tracklysms.com/s/<your-slug>`
3. Mobile visitors will be taken directly to their SMS app; desktop visitors see a web form