Using the finishappUrl parameter
What is finishAppUrl?
You can use the finishAppUrl parameter to configure a multi-step application process using Indeed Apply.
Including the finishAppUrl parameter in your IA configuration alerts job seekers of an additional step needed to complete the application process. Use this option to send job seekers to more complex application processes that aren’t currently supported by Indeed Apply.
Parameters configured as part of finishAppUrl are encrypted and passed to the employer in real time. This contrasts with POST data, which could take some time to receive.
Criteria for finishAppUrl access
Use finishAppUrl to support complex application processes Indeed cannot replicate such as:
- Third-party verification (e.g. background checks)
- Video interview
- Work sample submission
- Unsupported screener question types (complex/relational, checkbox)
- Legal forms that require a mandated format (consult your legal team for specific requirements)
The finishAppUrl parameter should not be used for the following:
|Redundant Questions||The linked-to application must not contain questions already asked via Indeed Apply.|
|Account Creation||Account creation for the purpose of applying for a job must be completed through Indeed OAuth.|
If you intend to use finishAppUrl in these ways, Indeed cannot approve your access.
If you use finishAppUrl to send job seekers to additional steps for the application process, those steps must meet these requirements:
- All Indeed applications are visible to the employer. Applications can be displayed as “incomplete” if the finishAppUrl section is not yet finished.
- All partners must display the full count of applicants from Indeed. If an applicant does not finish the application on their end, they still have to display the count to their customers. They can display unfinished applications as “incomplete.”
- Job seeker application experience is optimized for mobile users.
Implement the finishAppUrl parameter as described in the following table and sections. To learn more about using other IA configuration parameters, see IA Configuration parameters.
||No||A URL that the job seeker is prompted to visit after applying by clicking the Continue button on the application confirmation page. Encode this URL in XML files.
Note: Do not use the
Including the pingback
If you use the
finishAppUrl parameter, Indeed requires that you send notification that the application has been completed. You do this by using a specific pingback URL.
Connect to the following URL:
||The public API token provided by Indeed.|
Supported finishAppUrl parameters
You can add append parameters to the configured finishappURL and retrieve reusable information later. We currently support the following parameters:
indeed_apply_id– Unique identifier for the application
name– Job seeker’s full name
phone– Job seeker’s phone number (if entered)
firstname– Job seeker’s first name (can only be used if
lastname– Job seeker’s last name (can only be used if
These parameters can be used in any order, and they can be assigned to any variable as part of
Example of finishAppUrl
Encryption and decryption
finishAppUrl, Indeed encrypts and passes url parameters in real time to the
finishAppUrl. The same encryption method detailed in the Adding Indeed Apply section is used, and you will need to decrypt these values.
Example of finishAppUrl with encrypted job seeker information
The parameters in the example URL are encrypted and decrypted as follows:
|Parameter||Encrypted Value||Decrypted Value|