OAuth status codes
Learn about the Marketplace status codes for both OAuth and API request to indicate the success or failure of your requests.
OAuth
https://oauth.pipedrive.com
| Status Code | URL | Message | Description |
|---|---|---|---|
200 OK | /oauth/token | Example response: { "access_token": "ACCESS_TOKEN", "token_type": "Bearer", "expires_in": 3600, "refresh_token": "REFRESH_TOKEN", "scope": "..scopes..,base" } | |
400 Bad Request | /oauth/token | Missing parameter: grant_type | Required parameter grant_type is not provided |
Unsupported grant type: grant_type is invalid | Provided parameter grant_type is not valid. Supported values: authorization_code, refresh_token, exchange_api_token | ||
Invalid grant: authorization_code is invalid | Provided value of authorization_code parameter is not valid or was already exchanged to ACCESS TOKEN | ||
Invalid grant: authorization_code has expired | More than 5 minutes passed after issue of provided authorization_code and it became invalid | ||
Invalid grant: refresh_token is invalid | Provided refresh_token is not valid for provided client credentials or it was already exchanged | ||
Invalid grant: api_token is invalid | Provided parameter api_token is not valid for any Pipedrive user | ||
| Invalid client: cannot retrieve client credentials | Both or at least one of required parameters client_id or client_secret were not provided in the request | ||
| Invalid client: client is invalid | Provided values of client_id or client_secret are not valid | ||
Invalid request: redirect_uri is not a valid URI | Required parameter redirect_uri is not provided or value is not a valid URI | ||
Invalid request: redirect_uri is invalid | Provided value of redirect_uri parameter doesn't match with value defined in Developer Hub | ||
Invalid request: content must be application/x-www-form-urlencoded | Request to OAuth should have Content-Type application/x-www-form-urlencoded | ||
| /oauth/authorize | App cannot be installed for requested company | User tried to install app that was removed from the Marketplace or not visible for last active user company in Pipedrive | |
500 | * | Internal Server Error | |
503 | /oauth/authorize | Whoops! Something broke in our servers and we cannot serve you this page. | Company database of Pipedrive user is under maintenance |
API request
https://companydomain.pipedrive.com/api/v1/
| Status Code | Message | Description |
|---|---|---|
200Â OK | ||
201Â Created | Resource created | |
204 No Content | No content (purpose can be different for different resources) | |
400 Bad Request | Invalid request: malformed authorization header | Provided value of access token in Authorization header doesn't follow format Bearer ACCESS_TOKEN |
| (An explanation of what went wrong, which can be different for different resources) | Request contains invalid or missing data. Mostly relevant for POST and PUT requests. | |
401Â Unauthorized | Invalid token: access_token is invalid | Provided access_token in Authorization header is not valid |
403Â Forbidden | Scope and URL mismatch | Not allowed to access requested resource by application scope that is defined by owner |
404 Not found | %Resource not found | |
410Â Gone | Old resource permanently unavailable | |
422 Unprocessable Entity | For example, when the webhooks limit is reached for a user or an app and it's forbidden to create a new one | |
429 Too Many Requests | Request over limit | API requests limit reached for a company |
500 | Internal Server Error |
Updated 4 months ago