---
title: "Create Job External Reference"
method: POST
path: "/jobs/external-references"
tags: ["jobs"]
---

# Create Job External Reference

`POST /jobs/external-references`

Use this endpoint to create a new external reference for a job to an external source and project.

This endpoint is rate limited. Use the `RateLimit-*` response headers to check current limits and remaining quota.

## Request body

- CreateExternalReferenceBodyPost
  - `jobId` string, uuid, required — The unique ID for the job (within Acculynx)
  - `source` string, required — The external source name
  - `projectId` string, required — The project identifier within the external source

## Response `201`

Created

- ExternalReference
  - `jobId` string, uuid — The unique ID for the job.
  - `companyId` string, uuid — The unique ID for the company.
  - `source` string — The source of the external reference
  - `projectId` string — The projectId of the external reference.

## Other responses

- `400` — Bad Request - The server cannot process the request due to a client error. Common causes: - Invalid request format - Missing required fields - Validation errors in the request data
- `401` — Unauthorized - Authentication is required or has failed. Common causes: - Missing API key - Invalid API key - Expired or deactivated API key
- `404` — Not Found - The requested resource does not exist. Common causes: - Invalid subscription ID - Subscription has been deleted - URL path contains typos or incorrect values
- `429` — Too Many Requests

---

[API](https://skmtc.net/acculynx/apis/acculynx-api-v2.md) · [All operations](https://skmtc.net/acculynx/apis/acculynx-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/acculynx/acculynx-api-v2/versions/3a9e3886e400/schema)