Add-to-List Webhooks
Every thanks.io mailing list has a built-in webhook URL. When your CRM fires that URL, the contact is automatically added to the list - no Zapier or third-party tools needed.
CRMs with pre-formatted webhook support include HighLevel, kvCORE/Bold Trail, Hubspot, Salesforce, and Sure Send.
Finding Your Webhook URL
-
In your thanks.io dashboard, go to Mailing Lists and open the list you want to add contacts to.
-
In the left column, scroll down to the Recipient Add Webhook section.

-
Click the copy button for your CRM:
- Copy Generic Code - for any CRM not listed below
- Copy HighLevel Code - pre-formatted with HighLevel merge fields
- Copy kvCORE/Bold Trail Code - pre-formatted for kvCORE and Bold Trail
- Copy Sure Send Code - pre-formatted for Sure Send
-
Paste the URL into your CRM's webhook settings.
Each mailing list has its own unique webhook URL. Copy it from the specific list you want contacts added to.
How the Webhook URL Works
The URL uses simple key-value pairs after the ? to tell thanks.io where to put each piece of contact data:
key=value
Multiple fields are joined with &:
name=value&company=value&address=value
Your CRM replaces the bracketed placeholders (such as [NAME]) with the actual contact data when it fires the webhook. Different CRMs use different placeholder formats - for example ~VALUE~ or {VALUE}. Refer to your CRM's documentation for the exact syntax it expects.
All the keys in the grey Webhook URL box are already correct for thanks.io - just copy them as-is.
Available keys
| Key | Description |
|---|---|
name | Full name |
firstname | First name |
lastname | Last name |
company | Company name |
address | Street address |
address2 | Address line 2 |
city | City |
state | State / Province |
postal_code | ZIP / Postal code |
country | Country |
email | Email address |
phone | Phone number |
dob | Date of birth |
custom1 - custom10 | Custom fields |
name, firstname, and lastname all represent the same data. Use one set or the other - not both. Sending duplicate information can cause issues.
CRM-specific guides
- HighLevel - step-by-step setup including workflow configuration
- Bold Trail / kvCORE - setup details for kvCORE and Bold Trail