Developer
The Developer sub-portal is where your technical team connects the platform to your own systems. Use it when you need to work with the API, react to events in real time, embed platform content on your sites, or send transactional messages from your applications.
What you can do here
- Get API credentials and authenticate requests, including partner keys for white-label and multi-account setups.
- Subscribe to outbound webhooks and push external events in through inbound webhooks.
- Embed subscribe forms and interactive content widgets on your own web pages, styled to match your brand.
- Secure microsites with single sign-on so known visitors arrive without a separate login.
- Send transactional email (receipts, password resets) and track its delivery and engagement.
- Look up environments, endpoints, rate limits, errors, and event payloads in the API reference.
Start here
- Make your first API call — Walk end to end through authenticating and calling an endpoint for the first time.
- Get your API credentials — Generate and locate the API keys needed to start making authenticated requests.
- Authenticate API requests — Attach API keys to requests and understand how key scopes control access.
- Environments and base URLs — Look up the sandbox and production endpoints and how each environment behaves.
- API Reference — Browse the full, OpenAPI-generated reference for every endpoint, parameter, and response.
In this section
Concept
- Webhooks overview — Understand inbound versus outbound webhooks and when to use each.
How To
- Get your API credentials — Generate and locate the API keys needed to start making authenticated requests.
- Authenticate API requests — Attach API keys to requests and understand how key scopes control access.
- Create and manage partner keys — Issue and rotate partner keys for multi-account and white-label integrations.
- Subscribe to outbound webhook events — Register endpoints to receive real-time notifications when events occur.
- Verify webhook signatures — Validate that incoming webhook requests genuinely came from the platform.
- Trigger actions with inbound webhooks — Push external events into the platform to drive automations and updates.
- Embed a subscribe form on your site — Add a hosted signup form to collect subscribers from your own website.
- Embed interactive content widgets — Place polls, surveys, and other interactive widgets on external web pages.
- Style and customize embedded forms — Match embedded forms and widgets to your brand and page layout.
- Set up single sign-on for microsites — Configure SSO so known visitors reach microsites without a separate login.
- Pass signed-in visitors to a microsite — Generate signed tokens that securely identify already-authenticated visitors.
- Send a transactional email — Trigger one-to-one messages like receipts and password resets through the API.
- Send transactional email from a template — Merge dynamic data into reusable templates when sending transactional messages.
- Track transactional delivery and engagement — Capture delivery status, opens, clicks, and bounces for transactional sends.
Reference
- Environments and base URLs — Look up the sandbox and production endpoints and how each environment behaves.
- API Reference — Browse the full, OpenAPI-generated reference for every endpoint, parameter, and response.
- API conventions: pagination, filtering, and sorting — Understand the shared request and response patterns used across all endpoints.
- API versioning and changes — Learn how API versions are released and how to keep integrations compatible over time.
- Webhook event reference — Look up every outbound event type and the structure of its payload.
- Embed configuration reference — Look up the attributes and options available for form and widget embeds.
- Microsite SSO token reference — Look up token parameters, claims, and signing requirements for microsite SSO.
- Rate limits and quotas — Understand request limits and how to handle throttling gracefully.
- Errors and status codes — Interpret error responses and follow recommended retry behavior.
- SDKs and Client Libraries — The API reference exists but there is no list of official SDKs/client libraries or per-language code samples, a standard developer-portal expectation.
Troubleshooting
- Troubleshoot webhook delivery — Diagnose missed, delayed, or failing webhook deliveries and retries.
Tutorials
- Make your first API call — Walk end to end through authenticating and calling an endpoint for the first time.
Canonical terms: Author, Edition, Folder (Project Folder), Broadcast, subscriber, SSO, Microsoft Entra ID.