> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sendora.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Integration safety checklist

> A production checklist for building Sendora API integrations without accidental side effects.

Use this checklist before connecting Sendora to an automation platform, worker, CRM, or customer-facing application.

## Before the first request

* Store `SENDORA_API_KEY` in a secret manager or environment variable.
* Use a deliberately isolated workspace for development. A `sk_test_` key is not automatically isolated from real data, sends, calls, or charges.
* Start with `GET` requests and confirm the workspace and resource IDs in the response.
* Treat IDs as opaque strings; never derive or expose internal database identifiers.

## Before every write

* Confirm the target workspace, resource, and intended side effect.
* Use an idempotency key when the endpoint documents one.
* Use preview endpoints before prospecting or bulk mutations.
* Use draft and preflight states before publishing or launching campaigns and voice agents.
* Keep bulk operations bounded and persist returned job or preview IDs.

## Never automate blindly

Do not automatically retry a request that can send a message, start a call, launch a campaign, publish an experience, change a plan, rotate a secret, or delete data. After a timeout, inspect the resource, job, or delivery history first.

## Production readiness

* Handle `401`, `403`, `404`, `409`, `422`, and `429` explicitly.
* Retry only transient `429` and `5xx` responses with exponential backoff and jitter.
* Verify webhook signatures using the raw request body before parsing it.
* Deduplicate webhook deliveries and make consumers safe for at-least-once delivery.
* Log request IDs, operation IDs, resource IDs, and job IDs without logging API keys or webhook secrets.
* Keep a tested key-rotation procedure for every integration.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.