Sign in

v1

latestOpenAPI 3.1.0Copyright Pismo2026-07-247702,7523.1 MB
Authentication

Get basic authentication access token

Generate an access token for use with basic authentication. <br/><br/> For more information, refer to Endpoints that require an account-specific token and Endpoints that require an external ID-specific token.

post/v2/s2s/access-token

Request body

server_keystring required

Server credential ID

server_secretstring required

Server credential secret

account_idnumber

Account ID for endpoints that require an account token

Example request

{
  "server_key": "5d8252ea2e6729223f30d477d79a5c3cb45f8e03",
  "account_id": 123
}

Response

Created

tenantstring

Tenant ID

server_keystring

Server credential ID

program_idsinteger[]

Array of program IDs for which the server is allowed to make authenticated requests

account_idnumber

Account ID

external_account_idstring

Account ID for endpoints that require an external account token. Used in place of the Pismo account ID.

rolesstring[]

Permissions roles associated with the generated access token

tokenstring

Pismo access token used to make authenticated requests

refreshstring

JWT used to refresh an expired Pismo access token

Example response

{
  "tenant": "TN-ab8b08af-8a20-44e3-a7ad-8329b3e42fa4",
  "server_key": "5d8252ea2e6729223f30d477d79a5c3cb45f8e03",
  "program_ids": [
    101,
    102,
    103
  ],
  "account_id": 123,
  "external_account_id": "5512990-642",
  "roles": [
    "onboarding-server",
    "account-server"
  ]
}