Sync Application Stages

All application stages should be sent via the Middleware Platform whenever they are created or updated in your ATS. Use both your application identifier and stage identifier when syncing application stages via API.

Throttle Limits

Throttle Limits	Requests Per Day (UTC)	Records Per Minute
Application maximum	100,000	10,000

Note

Please submit batch calls grouped with no more than 100 records in sequential order.

Sync Application Stages

Use the following endpoint to create and update application stages:

PUT https://api.linkedin.com/v2/atsApplications/atsJobApplicationId={id1}&dataProvider=ATS&integrationContext={organization URN}/stages?ids={stage id 1}&ids={stage id 2}

Request Body Fields

Field	Description	Format	Required
atsCreatedAt	Date record was created in your ATS. Must be greater than 0.	UTC Epoch Milliseconds	Yes
stage	Stage in which the application stayed supplied by external ATS (e.g. Phone Screen, Onsite Interview, Rejected, Hired, etc.). Must be at least one character and not Not Available.	string	Yes

Sample Request

Headers:

Authorization: Bearer {token}
x-restli-method: batch_update

Request Body:

{
  "entities": {
    "APPL_STAGE123": {
      "atsCreatedAt": 1484864187000,
      "stage": "Offer Extended"
    },
    "APPL_STAGE456": {
      "atsCreatedAt": 1485794842000,
      "stage": "Offer Accepted"
    }
  }
}

Sample Response

A successful request will return a 200 OK response code, and you will find the status of each entity in the response body.

Sample Response Body

{
    "errors": {},
    "results": {
        "APPL_STAGE123": {
            "status": 204
        },
        "APPL_STAGE456": {
            "status": 204
        }
    }
}

Note

• Be sure to check the response for error statuses corresponding to individual entities you submit.

Delete Application Stages

API Details

Perform HTTP DELETE on the endpoint /atsApplications/{JobApplicationIdentifier}/stages to delete Job Application Stages. More information is available here.