Skip to main content

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

  1. In your thanks.io dashboard, go to Mailing Lists and open the list you want to add contacts to.

  2. In the left column, scroll down to the Recipient Add Webhook section.

    The Recipient Add Webhook box showing the webhook URL and copy buttons for Generic, HighLevel, kvCORE/Bold Trail, and Sure Send

  3. 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
  4. 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

KeyDescription
nameFull name
firstnameFirst name
lastnameLast name
companyCompany name
addressStreet address
address2Address line 2
cityCity
stateState / Province
postal_codeZIP / Postal code
countryCountry
emailEmail address
phonePhone number
dobDate of birth
custom1 - custom10Custom fields
Avoid duplicate 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