Build an Integration End-to-End

Build an Integration End-to-End This guide walks through everything you need to run Relaytiv from your own code, without ever opening the dashboard. By the end you will have built a minimal integration that: Authenticates with an API key Creates an AI Agent and configures its assistant behaviour Connects a messaging channel (we use WhatsApp Web as the worked example) and points it at the Agent Imports contacts Sends and reads messages Reads analytics Subscribes to webhooks for real-time events Every step links to the full resource guide so you can dig into the details when you need them. This page is the map; the resource guides are the territory. Before you start. API access is a paid feature. If your plan does not include it, every request returns 403 . See API Access to confirm it is enabled, and Authentication for all the ways to pass your key. All paths below are relative to the base URL: https://api.relaytiv.com/v1 Step 1 — Get an API key and make your first request Your API key lives in the app under Settings → Integrations → API Key — its own section under Integrations, separate from Webhooks, which only appears once API access is on the plan. Generate one, copy it, and store it somewhere safe (a server-side secret store or environment variable — never in browser code). Full instructions are in API Access . Once you have a key, confirm it works by calling the health endpoint. There are several ways to send the key; the simplest is the ?apiKey= query parameter, but for