Skip to main content

Search

Let us guide you!

Incoming Webhook trigger: receive data

The Incoming Webhook trigger starts a TimeTonic automation when an external tool sends an HTTP request to a dedicated URL.

The external tool can be an external automation tool, a website form or a custom script. The content of the call, in JSON format, becomes variables you can use in your actions.

You need: a TimeTonic automation with this trigger, and a tool that can send a POST request to the generated URL.

Last updated: 13-10-2026.

Contents
  1. 1. What is the Incoming Webhook trigger for?
  2. 2. What does the configuration window contain?
  3. 3. How do I secure the webhook with a password?
    1. 3.1 Call the webhook without a password
    2. 3.2 Call the webhook with a password
  4. 4. How do I define the data structure?
  5. 5. How do I choose the row identification?
    1. 5.1 Unique row creation
    2. 5.2 Identify via the row ID
    3. 5.3 Identify via a field value
  6. 6. How do I get the webhook URL?
  7. 7. Go further

1. What is the Incoming Webhook trigger for?

It connects TimeTonic to your other services: each external event can create or update a row, then run your actions. These are the most common use cases.

Create a row from an external form

A form filled in on a website automatically creates a row in TimeTonic.

Receive data from a third-party app

A CRM or a prospecting tool sends its data to a TimeTonic table to centralize it.

Update an existing row

A status change in another system updates the matching row.

Trigger an automation

An external event starts an automation scenario: new sale, new contact, new ticket.

Synchronize part of the data

Only the information a team needs goes from the business tool to TimeTonic.
Triggers list with the Incoming webhook option,

2. What does the configuration window contain?

Read the Webhook trigger window from top to bottom. Three numbered areas set the security, the incoming data and the targeted row.

Incoming webhook window with three numbered areas: Webhook password, Data structure and Row identification
1. Webhook password

Protects the URL: without a password, every call is accepted.

2. Data structure

Turns the properties of the received JSON into local variables.

3. Row identification

Chooses between creating a row, finding it by its ID or by a field value.

3. How do I secure the webhook with a password?

The password is optional. If you set one, TimeTonic only accepts calls that carry the right signature. Without a password, every call is accepted with no check.

3.1 Call the webhook without a password

No authentication is required. The HTTP request is sent without any additional header.

Incoming webhook window with the Webhook URL area and the Webhook password field left empty
Setting in the calling tool Value
Method POST
Target URL https://automationsv2.timetonic.com/api/automation/trigger/XXXXXXXXX
Authentication None

3.2 Call the webhook with a password

The call must include a SHA-256 hash of the body content followed by the password. Put this hash in the X-PayloadSeal header.

Password rules: at least 8 characters, with a digit, a lowercase letter and an uppercase letter. No spaces.
Incoming webhook window with the Webhook password field filled in and the webhook URL shown above it
Setting in the calling tool Value
Method POST
Target URL https://automationsv2.timetonic.com/api/automation/trigger/XXXXXXXXX
Password encoding SHA-256 of {body} + password
Put it in the X-PayloadSeal header
Request header { "X-PayloadSeal": "your_hash_here" }
Request body {"id":"123"}

Example with the password TTisbeautiful3+:

SHA256('{"id":"123"}TTisbeautiful3+') ⇒ 748038153a8019809f364910b70410564dc8bf62ba2c8d831a4decd977fb74d6
Compute the hash on the exact body you send: one extra or missing space changes the result.

4. How do I define the data structure?

The data structure extracts elements from the received JSON and turns them into local variables. You then reuse them in your automation actions.

Data structure area with the Local variable name and Webhook property name columns
Structure field Example Description
Local variable name age The name you give the variable in TimeTonic to reuse it in your actions.
Webhook property name Age_du_participant The exact name of the key in the received JSON. Spaces are not allowed.

You can also paste a JSON in the editor with the Use JSON structure button:

{ "key1": "value1", "key2": "value2" }

Result: TimeTonic reads the JSON and creates the local variables key1 and key2, named after the properties.

5. How do I choose the row identification?

In the last step of the window, three options define what TimeTonic does with rows on each call received.

Option Effect Use when
Unique row creation Creates a new row. Each call must produce a distinct row.
Identify via the row ID Looks up the row by its TimeTonic ID. You already know the ID of the row to update.
Identify via a field value Compares a received variable to a table field. A unique field identifies the row: email, customer code.

5.1 Unique row creation

Each call creates a row, with no check on whether it already exists. This option suits forms, records and continuous logs.

1
In the external tool
Put the properties that carry your information in the request body. Example: name Age_du_participant, value 24.
2
In TimeTonic
Tick Unique row creation.
3
Write into the created row
Add the Row creation or Write to a field action. The webhook variable is at the bottom of the drop-down list.
Create row option ticked in the Row identification area
Add a new record action with the webhook variable age at the bottom of the drop-down list

5.2 Identify via the row ID

The call targets one precise row through its TimeTonic ID. Use this option when the ID comes from a previous step or from another system.

1
In the external tool
Put the row ID and the values to write in the request body. Example: ID = 12096043, then Age_du_participant = 24.
2
In TimeTonic
Tick Identify via the row ID, then select the local variable that carries the ID.
3
Write into the identified row
Add the Write to a field action. The webhook variable is at the bottom of the drop-down list.
Find by row ID option ticked with the list of local variables
Write into one or more fields action with the webhook variable age at the bottom of the drop-down list

5.3 Identify via a field value

TimeTonic compares the received value to a table field. It updates the first row that matches. With no match, the scenario stops.

1
In the external tool
Put the identification value and the other pairs to update in the body. Example: Age_du_participant = 24.
2
In TimeTonic
Tick Identify via a field value. Select the table field and the variable that carries the value.
3
Write into the identified row
Add the Write to a field action. The webhook variable is at the bottom of the drop-down list.
Find by field value option ticked with the table field Age and the webhook variable age

6. How do I get the webhook URL?

The URL only exists once the automation is created. Follow these steps, then copy the URL into your external services.

1
Validate the webhook
Validate the Incoming Webhook trigger settings.
2
Add your actions
Create one or more actions. See the overview of the 9 automation actions.
3
Title the automation
Enter a title for your automation.
4
Create it
Click the Create button.
5
Copy the URL
Reopen the Incoming Webhook trigger. The URL is generated: copy it into your external services.

Then keep editing your conditions and actions in the automation scenario. For conditions, see Conditions: operators, nested AND/OR, branches.

7. Go further

Go further

Action: Call an API

Send an HTTP request from TimeTonic to an external service.

Read more →

Go further

Conditions: operators, AND/OR, branches

Filter and steer your automation scenario.

Read more →

Go further

The 9 automation actions

Pick the action that follows your trigger.

Read more →
Aidez-nous à améliorer notre contenu : cet article vous a-t-il été utile ?
Utilisateurs qui ont trouvé cela utile : 3 sur 4
Return to top