Create CRM Contact Job

POST

/v1/create-crm-contact-jobs

Trigger an asynchronous job that creates a CRM Contact record in the account's primary CRM from a Leadfeeder contact, and connects the contact to it. Field mappings configured for the integration are respected. The job runs in the background; poll GET /v1/create-crm-contact-jobs/{job_id} and, once it completes, fetch the created record via GET /v1/crm-contacts/{id} using result.crm_record.id.

Credit Note: Creating a CRM record from a contact consumes 1 credit, unless the contact was already accessed within the last 12 months. The job's credits reports the charge.

INFO

Requires the crm_records:write OAuth2 scope.

Request

Authorization

API Key

Add parameter in header

X-Api-Key

Example:

X-Api-Key: ********************

Query Params

Body Params application/jsonRequired

Example

{
    "data": {
        "attributes": {
            "contact_id": "3219787601",
            "crm_owner_id": "4d5e6f70-8192-4a3b-9c4d-5e6f708192a3",
            "custom_values": {
                "Industry__c": "SaaS"
            }
        },
        "type": "create_crm_contact_job"
    }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://api.leadfeeder.com/v1/create-crm-contact-jobs?account_id=123456' \
--header 'X-Api-Key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "data": {
        "attributes": {
            "contact_id": "3219787601",
            "crm_owner_id": "4d5e6f70-8192-4a3b-9c4d-5e6f708192a3",
            "custom_values": {
                "Industry__c": "SaaS"
            }
        },
        "type": "create_crm_contact_job"
    }
}'

Responses

🟢202Accepted

application/json

Job accepted and started

Bodyapplication/json

Example

{
    "data": {
        "attributes": {
            "completed_at": null,
            "configuration": {
                "contact_id": "3219787601"
            },
            "created_at": "2026-09-23T12:00:00Z",
            "errors": [],
            "status": "running"
        },
        "id": "job_550e8400-e29b-41d4-a716-446655440000",
        "type": "create_crm_contact_job"
    },
    "meta": {
        "request_id": "cf054205-dd8c-4473-8689-07c30fe0789f"
    }
}

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

🟠422Parameter Error

🟠429

🔴500Server Error

🔴504Gateway Timeout

Modified at 2026-10-28 08:31:15

Get Connect CRM Record Job

Get CRM Contact Job