Quick Start
Get up and running with Mergent Tasks in minutes.
- 1.
- 2.
- 3.
Mergent authenticates your API requests using your project API keys. If you don't include your key when making an API request or use one that is incorrect or outdated, Mergent returns an error.
Mergent uses webhooks to notify your application when a task is ready to be performed.
For each task, Mergent
POST
s the task data to your endpoint in JSON format. At a minimum, your webhook endpoint needs to expect data through a POST
request and confirm successful receipt of that data.To acknowledge receipt of a Task, your endpoint must return a
200
or 201
HTTP status code to Mergent. All response codes outside this range, including 3xx
codes, indicate to Mergent that you did not receive the Task.If Mergent does not receive a
2xx
HTTP status code, the notification attempt is repeated. After multiple failures to send the notification over multiple days, Mergent marks the Task as failed and stops trying to send it to your endpoint.There are example implementations in the sidebar for some common libraries & frameworks.
To check that your integration is working correctly, make a test API request using your API key to create a task.
Using Next.js, JavaScript, TypeScript, or Ruby? There's a library. See the JavaScript / TypeScript or Ruby pages for details.
Here's an example using curl.
curl https://api.mergent.co/v2/tasks \
-u yourapikey: \
-d request[url]="https://example.com/webhook"

For all of the available configurations & parameters, please visit the API reference in the sidebar.
Last modified 3mo ago