Use IFTTT to connect Velaro with the apps and devices IFTTT supports. IFTTT talks to Velaro through its Webhooks service, using the Make a web request action, and Velaro can call an IFTTT webhook through a workflow.

Before You Start

In Velaro, go to Settings → API Keys → Create API key, name it for IFTTT, and choose the scopes you need: read:contacts and write:contacts for the examples here. Copy the key (it starts with vlk_) because it is shown only once. Create one key per tool so you can rotate it independently.

Connection Details

• Base URL: https://api-admin-us-east.velaro.com/api/v1
• Authorization header: Authorization: Bearer vlk_your_key
• Content type: application/json

Never put the key in a URL. See the REST API Guide for every endpoint and scope.

Call Velaro from IFTTT

1. In IFTTT, click Create.

2. Under If This, pick the trigger from the app you want (for example Google Sheets or a Webhooks event).

3. Under Then That, search for Webhooks and choose Make a web request.

4. Fill in the fields as shown below, then click Create action and Continue.

Use these values:

• URL: https://api-admin-us-east.velaro.com/api/v1/contacts
• Method: POST
• Content Type: application/json
• Additional Headers: Authorization: Bearer vlk_your_key
• Body: the JSON below

Example: Create a Contact and Tag It

Create or update a contact with a POST to https://api-admin-us-east.velaro.com/api/v1/contacts:

{"email":"jane@example.com","firstName":"Jane","lastName":"Doe","company":"Acme","tags":["ifttt-lead"]}

The reply includes the contact id and the tags applied. To add a tag later, send a POST to https://api-admin-us-east.velaro.com/api/v1/contacts/tag with:

{"email":"jane@example.com","tag":"escalation-needed"}

The tag is created if it does not exist, and any Email Campaign set to start on "Contact tag added" begins for that contact.

IFTTT Limits

IFTTT has some limits worth knowing. Its simple event webhooks carry only three fixed value fields (Value1, Value2, Value3), so for Velaro use the Make a web request action with a JSON body and put every field you need in that one JSON document. Trigger ingredients can be placed inside the JSON text. Use the same approach for the tag call. IFTTT applets run on IFTTT's own schedule, so some triggers are not instant.

Send Velaro Events to IFTTT

To send events from Velaro to IFTTT, create an applet with the Webhooks trigger Receive a web request, and copy its URL (it looks like https://maker.ifttt.com/trigger/your_event/with/key/...). In the Velaro workflow editor add an HTTP Request node, paste that URL, set the method to POST and use a JSON body with value1, value2 and value3 keys. IFTTT receives these as the three event values.

Troubleshooting

Applet does not run: check the applet is turned on and look at its Activity log in IFTTT.

401 Unauthorized: confirm the header reads Authorization: Bearer vlk_... with your full key.

400 Bad Request: confirm Content Type is application/json and the body is valid JSON.