Skip to main content
POST
/
v1
/
oauth
/
token
cURL
curl --request POST \
  --url https://api.pipedream.com/v1/oauth/token \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "grant_type": "client_credentials",
  "client_id": "<string>",
  "client_secret": "<string>",
  "scope": "<string>"
}
'
{
  "access_token": "<string>",
  "token_type": "<string>",
  "expires_in": 123
}
If using one of the available SDKs in TypeScript, Python, or Java, the OAuth access token is automatically generated (and refreshed) for you when you initialize the client.
Create an OAuth client to get your client ID and secret:
  1. Visit the API settings for your Pipedream workspace.
  2. Click the New OAuth Client button.
  3. Name your client and click Create.
  4. Copy the client secret. It will not be accessible again. Click Close.
  5. Copy the client ID from the list.
Read more in the Authentication section.

​
OAuth scopes

You can optionally specify a scope parameter in the request body to limit the access token to specific operations. The scope parameter accepts a space-separated list of scopes. If no scope is specified, the token defaults to * (full access). Example request with scopes: 
curl -X POST https://api.pipedream.com/v1/oauth/token \
  -H 'Content-Type: application/json' \
  -d '{
    "grant_type": "client_credentials",
    "client_id": "YOUR_CLIENT_ID",
    "client_secret": "YOUR_CLIENT_SECRET",
    "scope": "connect:accounts:read connect:accounts:write"
  }'
View the full list of available scopes in the Authentication section.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Request object for creating an OAuth token

​
grant_type
enum<string>
required
Available options:
client_credentials
​
client_id
string
required
​
client_secret
string
required
​
scope
string

Optional space-separated scopes for the access token. Defaults to '*'.

Response

200 - application/json

token created

Response object for creating an OAuth token

​
access_token
string
required
​
token_type
string
required
​
expires_in
integer
required