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.