Download schema markup
Select one or both of the schema markups to download
Tracking Event Sample Schema
Detailed tracking event sample schema
JSON Schema
Schema of all the Tracking Webhook API endpoints
You cannot create a webhook without accounts
Associate accounts to your organisation then you can create a webhook
All of your accounts are already associated with a webhook
Edit or delete your exisitng webhook(s) and then create a new webhook
The FedEx APIs support the OAuth 2.0 (bearer token) authentication method to authorize your application API requests with FedEx resources. This OAuth access token needs to be regenerated after every 60 minutes and provided with each API transaction to authenticate and authorize your access to the FedEx resources.
This API allows you to authorize the API requests and it is required to authenticate the FedEx resources. The following section describes the prerequisites for the API:
While registering to FedEx Developer portal, FedEx provides a combination of Client ID (API Key) and Client Secret (Secret Key) to authenticate API requests for your project. Each project under your organization is associated with a combination of Client ID and Client Secret, called as API credentials.
Note: Customers (Internal, Compatible or Proprietary Parent Child) can contact FedEx representative to obtain API and Secret Keys.
To provide an extra layer of security, the FedEx ® customers (Internal, Compatible or Proprietary Parent Child) can send Child Key (Customer Secret) and Child Secret (Customer password) in addition to the API Key and Secret Key to create an OAuth token. This token is used in every API request for authentication.
You can recreate the forgotten Secret Key from the Projects page on the FedEx Developer Portal.
Note: Creation of new keys will result into code change in your application.
Important information in this document:
API credentials serve the following purposes:
Credentials are created based on inputs in the FedEx Developer Portal:
Note: FedEx ® customers (Internal, Compatible or Proprietary Parent Child) need to send Child Key (Customer Secret) and Child Secret (Customer password) in addition with API Key and Secret Key for creating OAuth token. Refer Credential Registration API for how to get Child Key and Child Secret.
API Authorization
Once you have secured the API credentials on FedEx Developer portal, the OAuth endpoint is used to get an access token which is used as credentials with each API transaction.
These are the required inputs associated with the OAuth request:
For FedEx ® Internal, Compatible or Proprietary Parent Child customers, send the below additional inputs:
The result of this request should return below:
POST /oauth/token HTTP/1.1
grant_type= client_credentials&client_id=your client ID&client_secret=Your secret
Request For FedEx ® Internal or Compatible customers:
POST /oauth/token HTTP/1.1
grant_type= csp_credentials&client_id=Client ID&client_secret= Client secret&child_key=Child key&child_secret=Child Secret
Request For FedEx ® Proprietary Parent Child customers:
POST /oauth/token HTTP/1.1
grant_type= client_pc_credentials&client_id=Client ID&client_secret= Client secret&child_key=Child key&child_secret=Child Secret
Note: The access token expires in an hour, it can be regenerated by using a POST request to the oauth/token endpoint.