HTTP Source

The HTTP source lets you send events to RudderStack using standard HTTP REST API requests.

This guide will help you set up and use the HTTP source in RudderStack.

Overview

The HTTP source is helpful for server-to-server data ingestion, making it ideal for backend services, microservices, and serverless functions that need to send event data to RudderStack.

Some key features of this source integration are listed below:

• Zero configuration: No source-specific settings required — this integration works out of the box
• Server-side processing: Events are processed by RudderStack’s cloud infrastructure
• Standard HTTP API: Uses standard REST API endpoints for event ingestion
• Universal compatibility: Works with any application that can make HTTP requests
• Full event support: Supports all standard RudderStack event types (track, identify, page, screen, group, alias)

Get started

1. Go to your RudderStack dashboard and click Add Source.
2. From the list of Event Streams sources, select HTTP.
3. Assign a name to your source and click Continue. Your HTTP source is now configured.

The HTTP source requires no additional setup — it is ready to use immediately.

4. Go to the Settings tab of the source and copy your source write keyThe write key (or source write key) is a unique identifier for your source. RudderStack uses this key to send events from a source to the specified destination. .
5. Go to the Connections tab and copy the data plane URLThe data plane URL is the location where events are routed and sent to the RudderStack backend for processing. You can find this URL in the home page of your RudderStack dashboard. .

Supported events

The HTTP source supports all standard RudderStack event types.

You can send events by making HTTP POST requests to the RudderStack API endpoint:

POST https://<DATA_PLANE_URL>/v1/<EVENT_TYPE>

The HTTP source supports the following endpoints:

API reference

See the RudderStack HTTP API documentation for more information on API authentication, endpoints, request/response format, response codes, and error handling.

Request size limits

RudderStack allows messages with a maximum size of 32KB per call.

The /v1/batch endpoint accepts a maximum call size of 4MB per batch and 32KB per call.

Examples

This section provides examples of how to use the HTTP source to send events to RudderStack.

Track event example

curl -u <WRITE_KEY>: -X POST <DATA_PLANE_URL>/v1/track \
  -H "Content-Type: application/json" \
  -d '{
    "event": "Product Purchased",
    "userId": "user123",
    "properties": {
      "productId": "prod-456",
      "price": 29.99,
      "currency": "USD"
    }
  }'

Identify event example

curl -u <WRITE_KEY>: -X POST <DATA_PLANE_URL>/v1/identify \
  -H "Content-Type: application/json" \
  -d '{
    "userId": "user123",
    "traits": {
      "email": "user@example.com",
      "name": "John Doe",
      "plan": "premium"
    }
  }'

Batch events

You can send multiple events in a single request using the batch endpoint:

curl -u <WRITE_KEY>: -X POST <DATA_PLANE_URL>/v1/batch \
  -H "Content-Type: application/json" \
  -d '{
    "batch": [
      {
        "type": "track",
        "event": "Product Purchased",
        "userId": "user123",
        "properties": {
          "productId": "prod-456"
        }
      },
      {
        "type": "identify",
        "userId": "user123",
        "traits": {
          "email": "user@example.com"
        }
      }
    ]
  }'

FAQ

When should I use the HTTP source?

Use the HTTP source when you need to:

• Send events from server-side applications (backend services, APIs, microservices)
• Integrate with systems that do not support RudderStack SDKs
• Send events from serverless functions or cloud functions
• Build custom integrations that require direct HTTP access
• Send events from environments where SDK installation is not feasible

What is the difference between the HTTP source and the SDK sources?

The following table highlights the key differences between the HTTP source and the SDK sources:

Questions? Contact us by Email or on Slack