LEleadfeeder
CRM
v1

Create CRM Lead Job

Changed on

Trigger an asynchronous job that creates a CRM Lead record in the account's primary CRM from a Leadfeeder company or contact, depending on what the target CRM supports for Lead creation, and connects it. Provide exactly one of company_id or contact_id. Field mappings configured for the integration are respected. The job runs in the background; poll GET /v1/create-crm-lead-jobs/{job_id} and, once it completes, fetch the created record via GET /v1/crm-leads/{id} using result.crm_record.id.

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

:::info Requires the crm_records:write OAuth2 scope. :::

post/v1/create-crm-lead-jobs

Request

  • Base URL
    https://api.leadfeeder.com
  • URL
    https://api.leadfeeder.com/v1/create-crm-lead-jobs
  • Auth
    • API key in header X-Api-Key
    • or OAuth 2
      Authorization code: https://api.leadfeeder.com/v1/oauth/authorize
      Token URL: https://api.leadfeeder.com/v1/oauth/token scopes: crm_records:write

Query parameters

account_idstring required

The Leadfeeder Account ID. The Account ID can be retrieved using the List Accounts endpoint.

Request body

Example request

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

Response

Job accepted and started

Example response

{
  "data": {
    "attributes": {
      "completed_at": "2026-09-23T12:00:12Z",
      "configuration": {
        "company_id": "159001425",
        "contact_id": "3219787601",
        "crm_owner_id": "4d5e6f70-8192-4a3b-9c4d-5e6f708192a3",
        "custom_values": {
          "Industry__c": "SaaS"
        }
      },
      "created_at": "2026-09-23T12:00:00Z",
      "credits": {
        "consumed": 0.3,
        "estimated": 0.6
      },
      "errors": [
        {
          "code": "job_failed",
          "title": "External contact data provider timeout"
        }
      ],
      "result": {
        "crm_connection": {
          "id": "42_159001425_9f1c2d3e-4b5a-6c7d-8e9f-0a1b2c3d4e5f",
          "type": "crm_connection"
        },
        "crm_record": {
          "id": "9f1c2d3e-4b5a-6c7d-8e9f-0a1b2c3d4e5f",
          "type": "crm_organization"
        }
      },
      "status": "running"
    },
    "id": "job_550e8400-e29b-41d4-a716-446655440000",
    "type": "create_crm_lead_job"
  },
  "meta": {
    "request_id": "cf054205-dd8c-4473-8689-07c30fe0789f"
  }
}

Changes