Zapier

To use TextLink for your Zapier workflows (Zaps), you firstly need to create an account and finish the device setup.

Trigger for receiving SMS

You can use TextLink webhooks to trigger a workflow in Zapier. In this example, you will learn how to setup the trigger for received SMS, but other triggers can be done almost identically ().

  1. When choosing the trigger for your workflow, select , and under Trigger event, select Catch Hook:

  2. In the Configure step, you can safely click Continue, and skip to the next step

  3. Click the Copy button next to the generated URL:

  4. Go to TextLink API dashboard ("API & Hooks" page), and paste the copied URL into the input for the action that you would like to use to trigger your webhook (in our case Receive SMS action). Also if you have not set a webhook secret, click the Generate button next to the webhook secret. That secret is only known to you and our servers, and you can use it to authorize requests if needed.

  5. Click Save and then Test webhooks. If everything is working, you should get the following confirmation:

  6. Go back to Zapier, and click the Test trigger button. You should now see the test request. Click Continue with selected record

  7. Congratulations! You have completed the trigger setup. You can now easily use the Webhook data in next steps.

(Optional) Webhook authorization

As mentioned earlier, you can specify a secret in your Webhook configuration. Only you and our server knows that secret. You can confirm that the request is coming from our server by adding the component at the beginning of your workflow. On the Configure & test tab, for the first value, select Secret field from the previous steps, for the second value select (Text) Exactly matches, and paste your webhook secret into the third value.

Using the API (Sending an SMS + More)

You can call any endpoint defined on the API page from Zapier. This example shows how to create a send SMS action.

  1. When choosing the app for your action, select , and under Action events, choose POST:

  2. On the configure tab, enter the API url, select JSON for payload type, and enter the data required by the endpoint (you can click + to reuse data from previous steps). For send-sms, required fields are phone_number and text.

  3. Don't wrap request in array, don't insert any file, unflatten is optional and don't use basic auth. Add one Header called Authorization, and its value should be Bearer YOUR_API_KEY, where YOUR_API_KEY can be found in the API dashboard.

  4. That's it! You can trigger other API endpoints similar way.

Last updated