Lockbox Providers

Provisioning

For dedicated PO boxes, the provisioning flow is as follows. See the Provision a Lockbox 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 /lockbox/provision
{
  "request_id": "req_01kkmjrdgdjtwgk7wdkba1kn9s",
  "location_id": "po_9876",
  "address": {
    "line1": "123 Main St",
    "line2": "STE 12345",
    "city": "New York",
    "state": "NY",
    "zip": "12345-1234"
  }
}

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)