curl --request POST \
  --url https://openapi.enginy.ai/v1/actions \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "actions": [
    {
      "type": "VERIFY_LEAD_EMAIL"
    }
  ],
  "contactIds": [
    123,
    456
  ],
  "webhookUrl": "https://your-domain.com/webhooks/enginy"
}
'

{
  "status": "success",
  "message": "<string>",
  "data": {
    "actionsId": 123,
    "createdAt": "2023-11-07T05:31:56Z",
    "nextStep": "<string>",
    "skippedContacts": {
      "reason": "COMPANY_HAS_NO_DOMAIN",
      "count": 2,
      "contactIds": [
        123
      ]
    },
    "destinationLists": [
      {
        "listId": 123,
        "listAppUrl": "<string>",
        "autoCreated": true
      }
    ],
    "warnings": [
      "<string>"
    ]
  }
}

Actions

Start an actions run

Creates an actions run to execute one or more workflow actions on contacts, companies, or lists. Supports optional webhook notifications when actions complete. See the “Actions Completed Webhook” in the Webhooks section for the webhook payload structure and implementation details.

Action reference:

VERIFY_LEAD_EMAIL: Verify the deliverability and validity of an email address Targets: Contacts only. Pricing: call GET /v1/credits/pricing and look up action VERIFY_EMAIL for the current workspace credit cost.
VERIFY_LEAD_PHONE: Verify the validity and type of a phone number Targets: Contacts only. Pricing: call GET /v1/credits/pricing and look up action VERIFY_PHONE for the current workspace credit cost.
SCRAPE_LEAD_FROM_LINKEDIN: Extract contact information from their LinkedIn profile Targets: Contacts only. Pricing: call GET /v1/credits/pricing and look up action SCRAPE_LEAD_LINKEDIN for the current workspace credit cost.
LINKEDIN_FROM_NAME_LASTNAME_COMPANY: Find LinkedIn profile URL using first name, last name and company name Targets: Contacts only. Pricing: call GET /v1/credits/pricing and look up action SCRAPE_LEAD_LINKEDIN for the current workspace credit cost.
SCRAPE_COMPANY_FROM_LINKEDIN: Extract company information from their LinkedIn profile Targets: Companies only. Pricing: call GET /v1/credits/pricing and look up action SCRAPE_COMPANY_LINKEDIN for the current workspace credit cost.
COMPANY_LINKEDIN_FROM_NAME: Find company LinkedIn profile URL by name or domain, with optional exact-domain, exact-name, or similar-name match modes Targets: Companies only. Pricing: call GET /v1/credits/pricing and look up action SCRAPE_COMPANY_LINKEDIN for the current workspace credit cost.
SCRAPE_COMPANY_ACCOUNTIQ_FROM_LINKEDIN: Extract AI-powered insights about a company from LinkedIn Targets: Companies only. Pricing: call GET /v1/credits/pricing and look up action SCRAPE_COMPANY_ACCOUNTIQ_FROM_LINKEDIN for the current workspace credit cost.
ENRICH_COMPANY_WITH_STORELEADS: Get ecommerce platform, technology stack, and store metrics from StoreLeads Targets: Companies only. Pricing: call GET /v1/credits/pricing and look up action ENRICH_COMPANY_WITH_STORELEADS for the current workspace credit cost.
ENRICH_WITH_EMAIL: Find and enrich contact with professional email addresses Targets: Contacts only. Pricing: call GET /v1/credits/pricing and look up action ENRICH_LEAD_EMAIL for the current workspace credit cost.
ENRICH_WITH_PHONE: Find and enrich contact with phone numbers Targets: Contacts only. Pricing: call GET /v1/credits/pricing and look up action ENRICH_LEAD_PHONE for the current workspace credit cost.
FILL_LEAD_WITH_SMART_FIELDS: Generate AI variable values for selected contact fields Targets: Contacts only. Pricing: call GET /v1/credits/pricing and look up action FILL_LEAD_WITH_SMART_FIELDS_AVERAGE for the current workspace credit cost.
FILL_COMPANY_WITH_SMART_FIELDS: Generate AI variable values for selected company fields Targets: Companies only. Pricing: call GET /v1/credits/pricing and look up action FILL_COMPANY_WITH_SMART_FIELDS_AVERAGE for the current workspace credit cost.
SEARCH_LEADS_FROM_LINKEDIN_COMPANY: Search and import contacts working at a specific company from LinkedIn. RECOMMENDED for agents/MCP: pass text (natural-language description like “Heads of Sales who changed jobs in the past 90 days”) — AI Finder produces the LinkedIn filters automatically. savedFilterId, filters, and keyword are also supported for callers that already have Sales Nav filter JSON. Targets: Companies only. Pricing: call GET /v1/credits/pricing and look up action SCRAPE_LEAD_LINKEDIN for the current workspace credit cost.
EXPORT_TO_CRM: Export contacts or companies to your connected CRM system Targets: Contacts or companies, depending on the IDs you provide. Pricing: this action does not expose a credit-mapped entry in GET /v1/credits/pricing.
SYNC_LEAD_WITH_CRM: Re-sync contacts with your connected CRM, pulling the latest CRM field values back into Enginy. Enable fullResync to reset the stored CRM identifiers and re-match each contact from scratch Targets: Contacts only. Pricing: this action does not expose a credit-mapped entry in GET /v1/credits/pricing.
SYNC_COMPANY_WITH_CRM: Re-sync companies with your connected CRM, pulling the latest CRM field values back into Enginy. Enable fullResync to reset the stored CRM identifiers and re-match each company from scratch Targets: Companies only. Pricing: this action does not expose a credit-mapped entry in GET /v1/credits/pricing.

Notes:

Provide exactly one target selector: contactIds, companyIds, contactGroupIds, or companyGroupIds.
Per-action option fields are documented on each item in the actions array.
Credit costs are workspace-specific; call GET /v1/credits/pricing before starting a run if you need the current cost table.

Required scope: ACTIONS_WRITE

Rate limit: 10 requests per minute

POST

actions

curl --request POST \
  --url https://openapi.enginy.ai/v1/actions \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "actions": [
    {
      "type": "VERIFY_LEAD_EMAIL"
    }
  ],
  "contactIds": [
    123,
    456
  ],
  "webhookUrl": "https://your-domain.com/webhooks/enginy"
}
'

{
  "status": "success",
  "message": "<string>",
  "data": {
    "actionsId": 123,
    "createdAt": "2023-11-07T05:31:56Z",
    "nextStep": "<string>",
    "skippedContacts": {
      "reason": "COMPANY_HAS_NO_DOMAIN",
      "count": 2,
      "contactIds": [
        123
      ]
    },
    "destinationLists": [
      {
        "listId": 123,
        "listAppUrl": "<string>",
        "autoCreated": true
      }
    ],
    "warnings": [
      "<string>"
    ]
  }
}

Authorizations

x-api-key

string

header

required

Body

application/json

Provide exactly one of contactIds, companyIds, contactGroupIds, or companyGroupIds to choose the target set. Use GET /v1/credits/pricing to inspect the current workspace credit costs before running billable actions.

actions

required

Array of actions to execute. Each action type documents its required data, behavior, accepted options, and how to look up credit pricing.

Minimum array length: 1

Show child attributes

contactIds

number[]

Array of contact IDs to run actions on

Minimum array length: 1

companyIds

number[]

Array of company IDs to run actions on

Minimum array length: 1

contactGroupIds

number[]

Array of contact list IDs to run actions on

Minimum array length: 1

companyGroupIds

number[]

Array of company list IDs to run actions on

Minimum array length: 1

webhookUrl

string<uri>

Optional webhook URL to receive notification when actions complete. Must be HTTPS in production.

Response

Actions run started successfully

status

enum<string>

required

Available options:

success

message

string

required

data

object

required

Show child attributes

API documentation

Endpoints

Start an actions run

Authorizations

Body

Response