How to Use Push API

Overview

The Introist Push API allows you to push data into Introist from your chosen data source. This guide explains how to use the API endpoint, including the required authentication and JSON body format.

Endpoint Details

• Method: POST

• URL: https://api.introist.com/ds/push/<datasource-id>

• Replace <datasource-id> with the unique identifier for your data source.

Authentication

To access this endpoint, you need an API key. Include the following header in your request:

Authorization: Bearer <api-key>

• Replace <api-key> with your actual API key.

• If you do not have your datasource-id or api-key, please contact Introist support.

Request Body

The request body must be a valid JSON object. Below is an example format:

{
  "field1": "value1",
  "field2": "value2",
  ...
}

Replace field1, field2, etc., with the fields and values specific to your use case. For detailed field requirements, consult the documentation or your account representative.

Example Request

Here is an example of a cURL request:

curl -X POST "https://api.introist.com/ds/push/1234" \
-H "Authorization: Bearer 1234abcd" \
-H "Content-Type: application/json" \
-d '{
  "firstname": "John",
  "lastname": "Doe"
}'

Common Issues and Troubleshooting

1. 401 Unauthorized Ensure your API key is valid and included in the request headers.

2. 404 Not Found Confirm the datasource-id is correct and exists in your account.

3. 400 Bad Request Verify the JSON body format.