v1
latestOpenAPI 3.0.02026-08-06114.9 KBPOST Postback API v2
Send data in POST payload to the v2 Postback endpoint.
Authentication is header-only. Provide one of:
- Authorization: TD1 <APIKEY>
- 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 body
object required
Response
Success.
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"
}