Lockbox Providers

Provisioning

For dedicated PO boxes, the provisioning flow is as follows. See the Provision a Mailbox API reference for endpoint details.

Also see: Mail Uploads | Rescans

1

Chariot requests a new PO Box via Email

Chariot sends an email to the lockbox provider containing:

  • The organization’s name and EIN (e.g., “Some Nonprofit, 12-3456789”)
  • A request ID generated by Chariot (e.g., req_01kkmjrdgdjtwgk7wdkba1kn9s)
2

Provider provisions the PO Box

The provider reserves and sets up the new PO box (e.g., PO 9876).

3

Provider notifies Chariot via API

Once the PO box is live, the provider sends a request to the Chariot provisioning endpoint:

POST /mailbox/provision
1{
2  "request_id": "req_01kkmjrdgdjtwgk7wdkba1kn9s",
3  "location_id": "po_9876"
4}

Request ID

  • The request ID is a one-time unique value generated by Chariot for each PO box request
  • The provider returns the request ID when notifying Chariot that the box has been provisioned
  • The request ID is not included in subsequent API calls (e.g., batch uploads)