Forms

Integrate with PageUp's Embedded Apply Forms API!

Contents

1. Overview
2. Requesting API Credentials
3. Before you begin
4. URL format

Overview

The Embedded Apply Forms API allows you to manage forms within the embedded apply workflow.

Requesting API Credentials

For information on how to obtain API credentials and to start integrating with the API, please visit the Getting started page.

Before you begin

To begin using any of the APIs, there are a few things that you will need:

1. Authentication credentials for the particular PageUp Customer/Client
2. You will need a valid (oAuth) JWT token to authorize yourself to access the end points in this API section. When requesting the bearer token with the authentication service please ensure you include the appropriate scope in the authentication request. Multiple scopes may be requested by specifying them as space separated list. The available scopes for the endpoints in this page are:

• Public.FormDefinition.Read

Requesting the oAuth token with the appropriate scope will allow you to use that token for calls against the respective functions that use that scope. See the implementation notes under each endpoint below to see which scope is needed for each endpoint.

URL Format

Root URL:
https://<environment>.<dataCentreId>.pageuppeople.com/v3/<tenantId>/recruitment/embedded-apply/forms/...

environment = 'api' for LIVE or 'apiuat' for UAT
dataCentreId = the data centre to connect to (e.g. dc2)
tenantId = the organisation's tenant Id

Please contact PageUp representative to find out the data centre and organisation's tenant Id if not known.

Examples:
LIVE 6784 environment for dc2: https://api.dc2.pageuppeople.com/v3/6784/recruitment/embedded-apply/forms/...
UAT 6784 environment for dc5: https://apiuat.dc5.pageuppeople.com/v3/6784/recruitment/embedded-apply/forms/...