Create and launch an LE job | Dealsignal

curl -X POST "https://app.dealsignal.com/api/v1/lead_enrichments?api_key=YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
  "lead_enrichments": {
    "name": "YOUR_UNIQUE_JOB_NAME",
    "source_type": "from_json",
    "match_field": "linkedin_url",
    "lead_data": {
      "keys": [
        "first_name",
        "last_name",
        "company_name",
        "email",
        "linkedin_url",
        "unique_identifier"
      ],
      "values": [
        [
          "Jane",
          "Smith",
          "Acme Corp",
          "jane@acme.example",
          "https://www.linkedin.com/in/jane-smith-example",
          "1"
        ],
        [
          "John",
          "Doe",
          "Globex Inc",
          "john@globex.example",
          "https://www.linkedin.com/in/john-doe-example",
          "2"
        ]
      ]
    },
    "append_company_data": true,
    "contact_profile_only": true,
    "contact_refresh_time": 30,
    "flag_if_lead_changed_company": true,
    "flag_if_lead_changed_title": true,
    "webhook": "https://your-server.com/webhooks/dealsignal"
  }
}'

Creates a new Lead Enrichment job and immediately launches it. The job runs asynchronously — poll GET /api/v1/lead_enrichments/{id} for status or provide a webhook to be notified on completion.

Query parameters

api_keystringRequired

Your Dealsignal API key. Obtain it from the Dealsignal dashboard.

Request

This endpoint expects an object.

lead_enrichmentsobjectRequired

Response

Job created and launched.

messagestringOptional

idintegerOptional

ID of the new job. Use it to poll status and fetch results.

Errors

401

Unauthorized Error

422

Unprocessable Entity Error