Skip to main content
POST
/
csv-enrichment
Create CSV Enrichment Job
curl --request POST \
  --url https://www.trysignalbase.com/api/v2/csv-enrichment \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "fileName": "target-accounts.json",
  "companies": [
    {
      "company_name": "Acme",
      "website_url": "https://acme.com",
      "linkedin_url": "https://www.linkedin.com/company/acme",
      "external_id": "acct_123"
    },
    {
      "company_name": "Stripe",
      "website_url": "https://stripe.com"
    }
  ]
}
'
{
  "success": true,
  "data": {
    "jobId": "7f4b7a34-8d65-4cc3-8ab0-3477f8a967a6",
    "detectedMapping": {
      "companyName": "company_name",
      "websiteUrl": "website_url",
      "linkedinUrl": "linkedin_url"
    }
  },
  "meta": {
    "endpoint": "csv.enrichment",
    "creditsUsed": 1,
    "creditsRemaining": 999
  }
}

Authorizations

​
Authorization
string
header
required

API key for Signalbase API authentication. Include as Bearer token in Authorization header.

Body

application/json
​
companies
object[]
required

Companies to enrich. Maximum 1,000 companies per request.

Required array length: 1 - 1000 elements

Company input. Include at least one of company_name, website_url, or linkedin_url. Additional fields are preserved on the enrichment job row.

​
fileName
string

Optional label stored on the enrichment job. Defaults to api-companies.json.

Maximum string length: 500
Example:

"target-accounts.json"

Response

Enrichment job created successfully

​
success
boolean
required

Indicates if the request was successful

Example:

true

​
data
object
required
​
meta
object
required