OAuth status codes

Learn about the Marketplace Status Codes for both OAuth and API request to indicate the success or failure of your requests.



Status Code




200 OK


Example response:


"access_token": "ACCESS_TOKEN", 
"token_type": "Bearer", 
"expires_in": 3600,
"refresh_token": "REFRESH_TOKEN", 
"scope": "..scopes..,base" 


400 Bad Request


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 the Marketplace Manager.

Invalid request: content must be application/x-www-form-urlencoded

Request to OAuth should have Content-Type application/x-www-form-urlencoded.


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.



Internal Server Error



Whoops! Something broke in our servers and we cannot serve you this page.

Company database of Pipedrive user is under maintenance.

API request


Status Code



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 Webhooks limit is reached for user or app and forbid to create new.

429 Too Many Requests

Request over limit

API requests limit reached for a company.


Internal Server Error

Read next