Addresses your code owns

An address does not have to have a person behind it. Five types, and the type decides what the address can do.

| Type | Inbox | For | | ----------- | ----- | --------------------------------------- | | Person | Yes | Somebody reads it. | | Team | Yes | Several people read it. | | Application | No | Mail becomes an event. Nothing to read. | | Workflow | No | Mail drives a process you wrote. | | AI agent | Yes | Software answers, a person can step in. |

application and workflow addresses have no inbox — mail arrives, an event fires, and there is nothing to read. That is not a limitation to work around; it is the point. An address whose whole job is to receive purchase orders should not accumulate a mailbox somebody has to remember to empty.

Create one

curl https://pidgeon.ai/api/v1/identities -H "Authorization: Bearer $PIDGEON_API_KEY" -H "Content-Type: application/json" -d '{
  "domain_id": "your-domain-id",
  "local_part": "receipts",
  "type": "application"
}'

Capabilities are derived, never stored

What an address can do is computed from its type and the account's plan every time it is asked, rather than written down when it is created. So an address cannot drift out of step with the plan it is on, and upgrading does not need a backfill.

That is also why a capability you do not have returns an empty result rather than an error where the question still makes sense — asking an application address for its threads is a reasonable question with the answer "none".

Routing, which is not an address

An extra address that delivers into an inbox you already have — hi@ into hello@ — is a routing rule rather than an identity. They are free on every plan and do not count against your mailboxes, and a rule cannot shadow a real address: the identity always wins for its own name.

Quotas

Mailboxes and programmable addresses are counted separately, because the abuse shapes differ. Fifty mailboxes is a small company; fifty agent addresses on a day-old free account is somebody testing how much they can take.