United States Postal Service Authentication

generated: '2026-11-11'
method: searched
source: https://developers.usps.com/getting-started; openapi/usps-addresses-openapi.yml, openapi/usps-adjustments-openapi.yml,
  openapi/usps-appointments-openapi.yml, openapi/usps-carrier-pickup-openapi.yml, openapi/usps-containers-openapi.yml, openapi/usps-domestic-labels-openapi.yml,
  openapi/usps-domestic-prices-openapi.yml, openapi/usps-informed-delivery-mail-campaigns-openapi.yml, openapi/usps-informed-delivery-package-campaigns-openapi.yml,
  openapi/usps-international-labels-openapi.yml, openapi/usps-international-prices-openapi.yml, openapi/usps-international-service-standards-openapi.yml
  ...
summary:
  types:
  - http
  - oauth2
  oauth2_flows:
  - authorizationCode
  - clientCredentials
schemes:
- name: OAuth
  type: oauth2
  flows:
  - flow: clientCredentials
    tokenUrl: /oauth2/v3/token
    scopes: 1
  - flow: authorizationCode
    authorizationUrl: /oauth2/v3/authorize
    tokenUrl: /oauth2/v3/token
    scopes: 1
  description: The specified APIs accept an access token formatted as a JSON Web Token. The relative path to the OAuth2 version
    3 API which supplies this access token is provided below for reference.
  sources:
  - openapi/usps-addresses-openapi.yml
  - openapi/usps-adjustments-openapi.yml
  - openapi/usps-appointments-openapi.yml
  - openapi/usps-carrier-pickup-openapi.yml
  - openapi/usps-domestic-labels-openapi.yml
  - openapi/usps-domestic-prices-openapi.yml
  - openapi/usps-international-labels-openapi.yml
  - openapi/usps-international-prices-openapi.yml
  - openapi/usps-locations-openapi.yml
  - openapi/usps-logistics-shipments-openapi.yml
  - openapi/usps-ncoa-openapi.yml
  - openapi/usps-pmod-openapi.yml
  - openapi/usps-qr-codes-openapi.yml
  - openapi/usps-reconciliation-adjustments-openapi.yml
  - openapi/usps-scan-forms-openapi.yml
  - openapi/usps-service-standards-files-openapi.yml
  - openapi/usps-service-standards-openapi.yml
  - openapi/usps-ship-enrollment-openapi.yml
  - openapi/usps-subscriptions-addresses-openapi.yml
  - openapi/usps-subscriptions-adjustments-openapi.yml
  - openapi/usps-subscriptions-disputes-openapi.yml
  - openapi/usps-subscriptions-ncoa-openapi.yml
  - openapi/usps-subscriptions-package-transaction-details-openapi.yml
  - openapi/usps-subscriptions-tracking-openapi.yml
  - openapi/usps-subscriptions-tracking-v3r2-openapi.yml
  - openapi/usps-subscriptions-unpaid-packages-openapi.yml
  - openapi/usps-tracking-openapi.yml
  - openapi/usps-tracking-v3r2-openapi.yml
  - openapi/usps-userinfo-openapi.yml
- name: OAuth
  type: oauth2
  flows:
  - flow: clientCredentials
    tokenUrl: /oauth2/v3/token
    scopes: 1
  description: The specified APIs accept an access token formatted as a JSON Web Token. The relative path to the OAuth2 version
    3 API which supplies this access token is provided below for reference.
  sources:
  - openapi/usps-containers-openapi.yml
  - openapi/usps-informed-delivery-mail-campaigns-openapi.yml
  - openapi/usps-informed-delivery-package-campaigns-openapi.yml
  - openapi/usps-international-service-standards-openapi.yml
  - openapi/usps-payments-openapi.yml
  - openapi/usps-service-standards-directory-openapi.yml
  - openapi/usps-shipping-options-openapi.yml
- name: BasicAuth
  type: http
  scheme: basic
  description: Use the client_id and client_secret for the username and password, respectfully. The client application is
    authenticated using the Basic authentication security scheme.
  sources:
  - openapi/usps-oauth-openapi.yml
- name: BearerTokenAuth
  type: http
  scheme: bearer
  bearerFormat: JWT
  description: An access token is used to authenticate the client application making the request.
  sources:
  - openapi/usps-oauth-openapi.yml
docs: https://developers.usps.com/getting-started
docs_summary: Create an app in the USPS Customer Onboarding Portal (COP); pass its Consumer Key and Consumer Secret as client_id
  and client_secret to the OAuth API; all USPS APIs require the token in the Authorization header using the Bearer Token scheme.
  Labels APIs additionally take an X-Payment-Authorization-Token from the Payments API.