# Torpedo ## Docs - [Create API key](https://torpedo.co.mz/docs/api-reference/api-keys/create-api-key.md): Creates a domain-scoped API key tied to a specific verified domain. No authentication required — provide your `workspaceId`. The plain key is returned **once only** — store it securely. - [List API keys](https://torpedo.co.mz/docs/api-reference/api-keys/list-api-keys.md): Returns all active API keys for the workspace. Plain keys are never returned. - [Revoke API key](https://torpedo.co.mz/docs/api-reference/api-keys/revoke-api-key.md): Permanently revokes an API key. The key cannot be restored. - [Add domain](https://torpedo.co.mz/docs/api-reference/domains/add-domain.md): Registers a sending domain and returns DNS records to add. Add the DKIM, SPF, and DMARC records to your DNS provider, then call `POST /api/v1/domains/{id}/verification-checks` to confirm the SES identity. Amazon SES verifies DKIM for the identity, but DMARC must be published by you in DNS. - [Check verification status](https://torpedo.co.mz/docs/api-reference/domains/check-verification-status.md): Triggers an immediate check against AWS SES. If your DNS records have propagated, the domain status will update to `verified`. - [Delete domain](https://torpedo.co.mz/docs/api-reference/domains/delete-domain.md): Removes the domain from Torpedo and AWS SES. - [Get domain](https://torpedo.co.mz/docs/api-reference/domains/get-domain.md): Returns domain details including current DNS record status. - [List domains](https://torpedo.co.mz/docs/api-reference/domains/list-domains.md) - [Get email](https://torpedo.co.mz/docs/api-reference/emails/get-email.md): Returns full email details including HTML/text body and delivery status. - [List emails](https://torpedo.co.mz/docs/api-reference/emails/list-emails.md) - [Send email](https://torpedo.co.mz/docs/api-reference/emails/send-email.md): Queues an email for delivery. Returns `202 Accepted` immediately — delivery is asynchronous. Use webhooks or poll `GET /api/v1/emails/{id}` for status. - [Send emails in batch](https://torpedo.co.mz/docs/api-reference/emails/send-emails-in-batch.md): Queues up to N emails (plan-dependent) in a single request. All emails are validated before any are queued — if any check fails the entire request is rejected. Returns an array of `{ id, status }` per email in the same order as the input. - [Get SMS message](https://torpedo.co.mz/docs/api-reference/sms/get-sms-message.md): Returns a single SMS message by ID. - [List SMS messages](https://torpedo.co.mz/docs/api-reference/sms/list-sms-messages.md): Returns a paginated list of SMS messages sent by the workspace, newest first. - [Send SMS](https://torpedo.co.mz/docs/api-reference/sms/send-sms.md): Queues an SMS message for delivery via SMPP. Returns `202 Accepted` immediately — delivery is asynchronous. Requires a paid plan and available SMS credits. - [List suppressed addresses](https://torpedo.co.mz/docs/api-reference/suppressions/list-suppressed-addresses.md): Returns addresses that are blocked from receiving emails due to hard bounces or spam complaints. Torpedo automatically adds addresses here — you can remove them if appropriate. - [Remove suppression](https://torpedo.co.mz/docs/api-reference/suppressions/remove-suppression.md): Removes an address from the suppression list. Future sends to this address will no longer be blocked. Use with caution — suppressed addresses were blocked for a reason. - [Create webhook](https://torpedo.co.mz/docs/api-reference/webhooks/create-webhook.md): Registers an HTTPS endpoint to receive event notifications. The `signingSecret` is returned **once only** — use it to verify the `X-Signature` header on incoming requests (HMAC-SHA256). - [Delete webhook](https://torpedo.co.mz/docs/api-reference/webhooks/delete-webhook.md) - [List delivery attempts](https://torpedo.co.mz/docs/api-reference/webhooks/list-delivery-attempts.md): Returns the delivery history for a webhook endpoint. - [List webhooks](https://torpedo.co.mz/docs/api-reference/webhooks/list-webhooks.md): Returns all registered webhooks. Signing secrets are never returned. - [Get workspace usage](https://torpedo.co.mz/docs/api-reference/workspace/get-workspace-usage.md): Returns current usage counts and plan limits for the authenticated workspace. - [Create workspace](https://torpedo.co.mz/docs/api-reference/workspaces/create-workspace.md): Creates a new workspace and returns a default API key. No authentication required — call this once to bootstrap your account. - [Authentication](https://torpedo.co.mz/docs/authentication.md): How API key authentication works in Torpedo - [Errors](https://torpedo.co.mz/docs/errors.md): Error response format and HTTP status codes - [Send emails in batch](https://torpedo.co.mz/docs/guides/batch-emails.md): Queue multiple emails in a single API call with POST /api/v1/emails/batch - [Manage suppressions](https://torpedo.co.mz/docs/guides/manage-suppressions.md): Understand and manage the suppression list - [Send an email](https://torpedo.co.mz/docs/guides/send-email.md): Everything you need to know about sending emails with Torpedo - [Send an SMS](https://torpedo.co.mz/docs/guides/send-sms.md): Send transactional SMS messages to Mozambican numbers with Torpedo - [SMS credits](https://torpedo.co.mz/docs/guides/sms-credits.md): How SMS credits work, pricing tiers, and how to top up your balance - [Verify a domain](https://torpedo.co.mz/docs/guides/verify-domain.md): Set up DNS records and verify your sending domain - [Webhooks](https://torpedo.co.mz/docs/guides/webhooks.md): Receive real-time delivery events from Torpedo - [Introduction](https://torpedo.co.mz/docs/introduction.md): Transactional email and SMS API for developers - [Quickstart](https://torpedo.co.mz/docs/quickstart.md): Send your first email in under 5 minutes ## OpenAPI Specs - [openapi](https://torpedo.co.mz/docs/openapi.yaml)