Skip to content


The Clickatell modules enable you to monitor new SMS, create a new SMS, or perform a custom API call in your Clickatell account.

Getting Started with Clickatell


  • A Clickatell account

In order to use Clickatell with Ibexa Connect, it is necessary to have a Clickatell account. If you do not have one, you can create a Clickatell account at


The module dialog fields that are displayed in bold (in the Ibexa Connect scenario, not in this documentation article) are mandatory!

Connecting Clickatell to Ibexa Connect

To connect your Clickatell account to Ibexa Connect you need to obtain the API Key from your Clickatell account.

  1. Log in to your Clickatell account.

  2. Go to SMS > Configure SMS. Add test phone to test the sending and/or receiving of messages from the Sandbox environment.

  3. Click the Create new integration button.


  4. Enter the name of the integration, select the environment (for testing purposes select the Sandbox option),and the REST API Type. Click Next.


  5. Select the desired features. Click Next.

  6. Switch on the Enable delivery notifications option to set up the webhook. For more details about the webhook see the Watch New SMS section. Click Next.

  7. Select your test phone.

  8. Save the integration setting by clicking the Finish button.

  9. Click the Integration you have created and copy the provided API Key.


  10. Go to Ibexa Connect and open the Clickatell module's Create a connection dialog.

  11. Enter the API Key you have copied in step 9 to the respective field and click the Continue button to establish the connection.

The connection has been established. You can proceed with setting up the module.


Watch New SMS

Triggers when an SMS is received.

The webhook URL needs to be generated in Ibexa Connect and then added to Clickatell's integrations settings.

  1. Add the Watch New SMS module to your Ibexa Connect scenario.

  2. Generate and copy the webhook URL.


  3. Log in to your Clickatell account.

  4. Go to SMS > Configure SMS and click the API key you are using for Ibexa Connect.

  5. Open the Settings tab and switch on the Enable delivery notifications option. Enter the webhook URL copied in step 2 above. Click Save.


Now, every time an SMS is received, the Watch New SMS module in your Ibexa Connect scenario is triggered.


Create an SMS

Sends an SMS.

Content Enter the text content of the SMS message.
To Add phone numbers you want to send a message to.

Make an API Call

Allows you to perform a custom API call.


Enter a path relative to

For example: /messages.

For the list of available endpoints, refer to the Clickatell Developer Documentation.


Select the HTTP method you want to use:


to retrieve information for an entry.


to create a new entry.


to update/replace an existing entry.


to make a partial entry update.


to delete an entry.


Enter the desired request headers. You don't have to add authorization headers; we already did that for you.

Query string

Enter the request query string.


Enter the body content for your API call.

Example of Use - Get a Balance

The following API call returns all the dashboards in your Datadog account:






The result can be found in the module's Output under Bundle > Body.

In our example, the balance of 0 EUR was returned: