Webhook / SDK

Push contacts into Helios from any system with a simple HTTP request.

The Webhook integration is the catch-all: if your system can send an HTTP request, it can push contacts into Helios. Use it for custom websites, internal tools, or third-party platforms that support outgoing webhooks (Zapier, Make, your own backend).

Requirements

The ability to send HTTP requests, nothing else.

Connect

1. Open Integrations → Webhook → Install.
2. Click Generate API Key. Use this key when sending data to the webhook endpoint.

Push a contact

Send a POST to the public endpoint:

curl -X POST https://api.sendhelios.com/v1/customer \
  -H "Content-Type: application/json" \
  -d '{
    "apiKey": "YOUR_API_KEY",
    "customer": {
      "phoneNumber": "+12015550123",
      "firstName": "Sam",
      "lastName": "Rivera",
      "email": "sam@example.com"
    },
    "properties": { "source_campaign": "spring-promo" },
    "addToLists": ["LIST_ID"]
  }'

• customer.phoneNumber is required; name and email are optional.
• properties saves custom fields onto the contact, usable in segments and personalization.
• addToLists / removeFromLists manage static list membership in the same call. Pair addToLists with an Added to list flow trigger to kick off automated follow-up instantly.

Contacts are matched by phone number: an existing contact is updated, a new one is created. Requests are processed asynchronously.

Full request/response details are in the developer docs and the API reference.

Ideas

• Wire your website’s custom signup form to Helios without using a hosted form.
• Use Zapier or Make to bridge any app with a “new customer” event into your texting list.
• Push attributes from your internal systems as properties, then segment on them.