Channel Connection API

Channel Connection API This guide shows you how to connect messaging channels to an account using the API. It is written for a developer building an integration or wrapper, so it focuses on the exact requests, the order to make them in, and the responses you get back. There is one pattern you need to understand up front, because it applies to almost every channel here. The connect-then-poll pattern Most channels cannot be connected with a single API call. Connecting WhatsApp, Instagram, or Messenger means the account holder has to log in to their own provider account and approve access. There is no headless (fully automated) path for that approval - a real person has to open a URL in a browser, or scan a QR code with their phone. So the flow is always: Start the connection with a POST . The response gives you either a URL to open, or a QR code to display. Hand that off to the end user - open the URL in their browser, or render the QR code on screen for them to scan. Poll the status endpoint with GET on a short interval (every few seconds) until the status reaches a connected state. Your integration's job is to drive that loop: show the URL or QR, then poll until done. Plan your UI around the poll - a spinner with a "waiting for you to finish in your browser" message works well. 📝 Note: Before you start, make sure API access is enabled on the plan and you have an API key. See API Access for how to generate one. All requests below use the base URL https://api.relaytiv.com/v1 a