Get up and running with Mergent Tasks in minutes.
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
POSTs the task data to your endpoint in JSON format. At a minimum, your webhook endpoint needs to expect data through a
POSTrequest and confirm successful receipt of that data.
To acknowledge receipt of a Task, your endpoint must return a
201HTTP status code to Mergent. All response codes outside this range, including
3xxcodes, indicate to Mergent that you did not receive the Task.
If Mergent does not receive a
2xxHTTP 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.
Here's an example using curl.
curl https://api.mergent.co/v2/tasks \
-u yourapikey: \
For all of the available configurations & parameters, please visit the API reference in the sidebar.