Changelog
Back to All

Configuration API - Expose source identifier

July 18th, 2024

Description

Configuration API endpoints expose additional property sourceIdentifier for the following source related endpoints:

  • GET /configuration/sources/{sourceType}/values
  • GET /configuration/sources/{sourceType}/values/{sourceValueId}

The enhanced Source object structure with sourceIdentifier property

     type: object
     required:
       - id
       - sourceIdentifier
       - label
       - sourceSubType
       - actions
     properties:
       id:
         type: string
       sourceIdentifier:
         type: string
         format: uuid
       label:
         type: string
       sourceSubType:
         $ref: '#/components/schemas/Identifiable'

Impact

The new property allows to obtain the source identifier for use with apply URL or posting URL every candidate you push to SmartRecruiters.
To know where the candidate came from you will need the sourcing identifier (TRID or SID).

Sourcing identifier is the query parameter at the end of apply / posting URL.

The URL have the following format:

https://apply_URL.?trid=sourceIdentifier

References