Before you begin
Make sure you have the following in place before using the API:- A published customer journey: A business user must first design and publish the journey in the GBG GO platform. If youâre unsure, check with your team to confirm the journey is ready.
- API access and credentials: You need an API client with a Client ID and Client secret. You create API clients yourself in the Account management portal. See Manage API clients to create one, and the next step, Authenticate, to learn how to use them.
- Understanding of your journeyâs tasks: Customer journeys may include document upload, ID checks, or biometric validation. Confirm which steps apply to your specific journey before integrating.
If youâre a business user, work with your developer or technical team to set
up the API integration once the journey is published.
Execution flow
A complete customer journey execution consists of six main steps:-
Authenticate
Get an access token to authorize API requests. -
Start a journey
Trigger a journey instance using the published journeyâs resource ID. -
Retrieve tasks
Fetch assigned tasks that need to be completed in the journey. -
Manage schemas
Retrieve schemas to understand the structure of required data for each task. -
Submit task data
Submit data to complete the journeyâs tasks. -
Fetch journey state
Check the journeyâs current progress or completion status.
If an API request fails, troubleshoot using the Handle errors
guide.