Skip to main content

Http Request Setup Guide

Prerequisites

  • An API endpoint that can receive HTTP POST requests in JSON format
  • The endpoint should be accessible from Matia's servers

Setup Guide

Configure Connection Settings

  • Endpoint Base URL: Enter the base URL of your HTTP API endpoint (e.g., https://example.domain/com/api)
  • Asset Name: Enter a name for this destination
  • Click Connect

Supported Streams

The HTTP Request destination takes data from any Matia source and sends it as a JSON payload to your specified endpoint. Each record from your source is sent as an individual HTTP POST request.

Payload Format

Records are sent as JSON objects with field names matching your configured mapping. For example:

{
"user_id": "123456",
"email": "user@example.com",
"last_active": "2023-06-15T14:30:00Z",
"subscription_status": "active"
}

Rate Limiting

  • If your endpoint returns a 429 status code, Matia will automatically retry with exponential backoff
  • Consider implementing proper rate limiting on your endpoint to avoid overloading your services