# Wirebox

- [Introduction](https://docs.wirebox.sh/index.md): The real-world identity and communication layer for AI agents.
- [Quickstart](https://docs.wirebox.sh/quickstart.md): Get your agent up and running with a real email address in under 5 minutes.
- [Authentication](https://docs.wirebox.sh/authentication.md): Learn how to authenticate requests to the Wirebox API using API keys.
- [Agent Identities](https://docs.wirebox.sh/concepts/identities.md): Understand agent handles, global namespaces, and communication channel bindings.
- [Email & Inboxes](https://docs.wirebox.sh/concepts/mailboxes.md): How agent inboxes, message exchanges, and replies work.
- [Webhooks & Delivery](https://docs.wirebox.sh/concepts/webhooks.md): Real-time HTTP push notifications with Bearer Token and HMAC signatures.
- [Receiving Inbound Email](https://docs.wirebox.sh/guides/receiving-email.md): How to handle incoming email payloads using Webhooks in Node.js and Python.
- [Sending Outbound Email](https://docs.wirebox.sh/guides/sending-email.md): How to send new emails and reply to existing conversation threads.
- [Verifying Webhook Signatures](https://docs.wirebox.sh/guides/verifying-webhooks.md): Verify HMAC-SHA256 signatures to ensure webhook payloads originate from Wirebox.
- [API Overview](https://docs.wirebox.sh/api-reference/overview.md): Base URLs, authentication headers, pagination, and error response standards.
- [Create Agent Identity](https://docs.wirebox.sh/api-reference/identities/create.md): Register a new autonomous agent identity and automatically provision a dedicated mailbox.
- [List Agent Identities](https://docs.wirebox.sh/api-reference/identities/list.md): Retrieve all agent identities registered within your organization.
- [Get Agent Identity](https://docs.wirebox.sh/api-reference/identities/get.md): Retrieve details and mailbox bindings for a specific agent identity.
- [Update Agent Identity](https://docs.wirebox.sh/api-reference/identities/update.md): Update display name or description for an existing agent identity.
- [Delete Agent Identity](https://docs.wirebox.sh/api-reference/identities/delete.md): Permanently delete an agent identity and unbind its associated mailbox.
- [List Mailboxes](https://docs.wirebox.sh/api-reference/mail/mailboxes.md): List all provisioned email inboxes in your organization.
- [List Conversation Threads](https://docs.wirebox.sh/api-reference/mail/threads.md): Retrieve grouped conversation threads scoped to an agent or mailbox.
- [List Messages](https://docs.wirebox.sh/api-reference/mail/messages.md): List email messages with full RFC headers, text/HTML content, and R2 attachment URLs.
- [Send Email](https://docs.wirebox.sh/api-reference/mail/send.md): Send an outbound email or reply to an ongoing conversation thread.
- [Create Webhook](https://docs.wirebox.sh/api-reference/webhooks/create.md): Register an HTTPS endpoint to receive real-time event notifications.
- [List Webhooks](https://docs.wirebox.sh/api-reference/webhooks/list.md): List all configured webhook subscriptions in your organization.
- [Get Webhook](https://docs.wirebox.sh/api-reference/webhooks/get.md): Retrieve configuration details for a specific webhook endpoint.
- [Update Webhook](https://docs.wirebox.sh/api-reference/webhooks/update.md): Update destination URL, subscribed events, or authentication token.
- [Delete Webhook](https://docs.wirebox.sh/api-reference/webhooks/delete.md): Permanently remove a webhook endpoint.
- [Rotate Webhook Secret](https://docs.wirebox.sh/api-reference/webhooks/rotate-secret.md): Immediately invalidate the current HMAC secret and generate a replacement secret.
- [Test Webhook Ping](https://docs.wirebox.sh/api-reference/webhooks/test-ping.md): Send an immediate diagnostic ping event to test connectivity, SSL handshake, and endpoint response.
- [Webhook Event Catalog](https://docs.wirebox.sh/api-reference/webhooks/events.md): Reference catalog and JSON payload schemas for all Wirebox webhook events.