Linkup API for LinkedIn icon

Linkup API for LinkedIn

Automate LinkedIn with Linkup

Overview

This node integrates with the Linkup API to automate LinkedIn Recruiter job posting creation. Specifically, the Recruiter - Create Job operation allows users to create new job postings on LinkedIn Recruiter via the API. This is useful for HR professionals and recruiters who want to programmatically manage job listings without manually using the LinkedIn interface.

Typical scenarios include:

  • Automatically creating job postings from an external applicant tracking system (ATS).
  • Bulk uploading multiple job openings.
  • Integrating job creation into broader recruitment workflows or automation pipelines.

For example, a recruiter could use this node to create a new job post titled "Software Engineer" located in "Paris" with a detailed HTML description, required skills, screening questions, and contact email, all sent directly to LinkedIn Recruiter.

Properties

Name Meaning
Job Title The title of the job to be created.
Job Location The location where the job is based.
HTML Description The job description formatted in HTML.
Employment Status Type of employment contract (e.g., CDD, CDI).
Workplace Type of workplace (e.g., Office, Remote).
Skills (JSON) Required skills expressed as a JSON array string.
Screening Questions (JSON) Screening questions expressed as a JSON array string.
Auto Rejection Template Template text used for automatic rejection messages.
Contact Email Email address for contacting regarding the job.
Country Code Country code for proxy selection and API routing (e.g., FR, US, UK). Defaults to "FR".
Timeout Request timeout in milliseconds (advanced option). Default: 30000 ms.
Retry Count Number of retries on failure (advanced option). Default: 3.

Output

The node outputs a JSON object containing the response from the Linkup API after attempting to create the job posting. The output includes:

  • The full API response data under the root level.
  • A _debug field containing:
    • requestBody: The exact request payload sent.
    • requestHeaders: HTTP headers used.
    • endpoint: The API endpoint URL called.
    • apiResponse: Raw API response.
  • A _meta field with metadata:
    • resource: The resource name ("recruiter").
    • operation: The operation name ("createJob").
    • timestamp: ISO timestamp of execution.
    • nodeVersion: Version of the node implementation.

If an error occurs, the output JSON will contain an error field describing the issue.

The node does not output binary data.

Dependencies

  • Requires an API key credential for the Linkup API to authenticate requests.
  • The node uses the Linkup API base URL: https://api.linkupapi.com/v1.
  • The user must configure credentials including API key and optionally LinkedIn email/password for some operations.
  • Network connectivity to the Linkup API endpoint is necessary.
  • Optional country code parameter influences proxy selection by the API.

Troubleshooting

  • Missing API Key Error: If the API key credential is not configured or invalid, the node throws an error indicating the missing API key. Ensure the API key is set up correctly in the node credentials.
  • Invalid JSON in Skills or Screening Questions: The node attempts to parse the skills and screening_questions fields as JSON arrays. If these are malformed, it falls back to sending the raw string, which may cause API errors. Validate JSON formatting before input.
  • Timeouts or Network Errors: The node has configurable timeout and retry count options. Increase timeout or retry count if experiencing intermittent network issues.
  • API Response Errors: Any error returned by the Linkup API will be included in the output's error field. Check the message for details such as invalid parameters or authentication failures.
  • Country Code Issues: Using an unsupported or incorrect country code may affect proxy routing and cause failures. Use standard country codes like "FR", "US", "UK", etc.

Links and References

  • Linkup API Documentation — Official site to get API keys and documentation.
  • LinkedIn Recruiter — Information about LinkedIn Recruiter product.
  • JSON validation tools — Useful for verifying skills and screening questions JSON format before input.

Discussion