Authentication Guide

For comprehensive details about authenticating with the Forage API, refer to the authentication guide.

Session Token Length

Session tokens are short-lived and expire after fifteen minutes.

Authentication Token Required

You need to create an authentication token before you can generate a session token.

A POST request to /session_token/ creates a new session token. The token is returned as the token value in the response body.

A session token is a temporary OAuth 2.0 bearer token that expires after 15 minutes.

Session tokens are used in client-side requests. For example, POSTs to create a Payment Method require session tokens in the Authorization header, and session tokens are passed as parameters to SDK methods that submit customer data.