Integrations

Sankofa exposes three core ingestion routes for custom integrations:

• POST /api/v1/track
• POST /api/v1/people
• POST /api/v1/alias

Those routes accept authenticated JSON payloads and resolve project context from the x-api-key header.

When to use direct ingestion

Use HTTP ingestion when:

• you are not integrating from Flutter
• you need server-side event forwarding
• you want to bridge an existing pipeline into Sankofa
• you need explicit control over transport and retries

Read this section in order

• HTTP ingestion guide
• API payload reference
• Alias and identity