TRtreasure

POST Postback API v2

Send data in POST payload to the v2 Postback endpoint.

Authentication is header-only. Provide one of:

  1. Authorization: TD1 <APIKEY>
  2. X-TD-Write-Key: <APIKEY>

URL-path keys (?td_write_key=...) accepted by the legacy endpoint are not supported here. If both headers are sent, Authorization takes precedence.

Note: Requests with an invalid API key return a 200 HTTP status code. This behavior is intentional and ensures a fast response, preventing ingestion from being canceled due to slow response. After the response is returned, the endpoint performs asynchronous validations. If the API key is invalid, an authentication failure will be raised despite the initial 200 status.

Maximum request body size is 1,048,064 bytes; larger payloads are rejected with 413.

post/postback/v3/event/{database_name}/{table_name}

Request

Request body

object required

Response

Success.

Content-Typestring
Datestring date-time
Strict-Transport-Securitystring
Content-Lengthinteger
Connectionstring

Example response

{
  "Content-Type": "application/json",
  "Date": "Wed, DD MM YYYY xx:yy:zz GMT",
  "Strict-Transport-Security": "max-age=31536000",
  "Content-Length": 2,
  "Connection": "keep-alive"
}

Changes

No recorded changes to this operation across all 1 revision of this API.