Claude Skills

Claude Skill - Company

Manage companies/organizations in Dalil AI CRM — create, read, update, delete, search, and list company records including name, domain, LinkedIn, address, employee count, and annual revenue.

Dalil AI: Company API Skills

Quick Reference

Base URL: https://app.usedalil.ai
Auth: Authorization: Bearer {apiKey}
Content-Type: application/json (POST/PATCH requests only)
Accept: application/json (GET requests)
Resource path: /rest/companies

GraphQL search (POST /graphql):

searchInput is a plain String! variable — do NOT pass as an object {query: "...", includedObjectNameSingulars: [...]} (causes type error)
limit must be hardcoded in the query string — do NOT pass as a $limit variable (causes type error)
Returns IDs only — always follow up with REST to fetch full records

Endpoints

Operation	Method	Path	Required Fields
Create	POST	`/rest/companies`	`name`
Get	GET	`/rest/companies/{id}`	`id` (path)
List	GET	`/rest/companies`	—
Update	PATCH	`/rest/companies/{id}`	`id` (path)
Delete	DELETE	`/rest/companies/{id}`	`id` (path)
Search by name	POST	`/graphql`	`searchInput`
Search by LinkedIn	GET	`/rest/companies?filter=...`	LinkedIn URL
Search by domain	GET	`/rest/companies?filter=...`	domain URL

Create Company

Request Body

{
  "name": "Acme Corp",
  "domainName": {
    "primaryLinkUrl": "https://acmecorp.com",
    "primaryLinkLabel": "Website",
    "secondaryLinks": []
  },
  "linkedinLink": {
    "primaryLinkUrl": "https://linkedin.com/company/acme-corp",
    "primaryLinkLabel": "LinkedIn",
    "secondaryLinks": []
  },
  "xLink": {
    "primaryLinkUrl": "https://x.com/acmecorp",
    "primaryLinkLabel": "Twitter",
    "secondaryLinks": []
  },
  "introVideo": {
    "primaryLinkUrl": "https://youtube.com/watch?v=example",
    "primaryLinkLabel": "Company Overview",
    "secondaryLinks": []
  },
  "industry": "Technology",
  "employees": 150,
  "idealCustomerProfile": true,
  "tagline": "Innovation at its finest",
  "visaSponsorship": false,
  "workPolicy": ["ON_SITE", "HYBRID"],
  "annualRecurringRevenue": {
    "amountMicros": 500000000000,
    "currencyCode": "USD"
  },
  "address": {
    "addressStreet1": "123 Main Street",
    "addressStreet2": "Suite 200",
    "addressCity": "New York",
    "addressState": "New York",
    "addressPostcode": "10001",
    "addressCountry": "United States",
    "addressLat": 40.7128,
    "addressLng": -74.0060
  },
  "accountOwnerId": "uuid-of-workspace-member"
}

{
  "name": "Acme Corp",
  "domainName": {
    "primaryLinkUrl": "https://acmecorp.com",
    "primaryLinkLabel": "Website",
    "secondaryLinks": []
  },
  "linkedinLink": {
    "primaryLinkUrl": "https://linkedin.com/company/acme-corp",
    "primaryLinkLabel": "LinkedIn",
    "secondaryLinks": []
  },
  "xLink": {
    "primaryLinkUrl": "https://x.com/acmecorp",
    "primaryLinkLabel": "Twitter",
    "secondaryLinks": []
  },
  "introVideo": {
    "primaryLinkUrl": "https://youtube.com/watch?v=example",
    "primaryLinkLabel": "Company Overview",
    "secondaryLinks": []
  },
  "industry": "Technology",
  "employees": 150,
  "idealCustomerProfile": true,
  "tagline": "Innovation at its finest",
  "visaSponsorship": false,
  "workPolicy": ["ON_SITE", "HYBRID"],
  "annualRecurringRevenue": {
    "amountMicros": 500000000000,
    "currencyCode": "USD"
  },
  "address": {
    "addressStreet1": "123 Main Street",
    "addressStreet2": "Suite 200",
    "addressCity": "New York",
    "addressState": "New York",
    "addressPostcode": "10001",
    "addressCountry": "United States",
    "addressLat": 40.7128,
    "addressLng": -74.0060
  },
  "accountOwnerId": "uuid-of-workspace-member"
}

{
  "name": "Acme Corp",
  "domainName": {
    "primaryLinkUrl": "https://acmecorp.com",
    "primaryLinkLabel": "Website",
    "secondaryLinks": []
  },
  "linkedinLink": {
    "primaryLinkUrl": "https://linkedin.com/company/acme-corp",
    "primaryLinkLabel": "LinkedIn",
    "secondaryLinks": []
  },
  "xLink": {
    "primaryLinkUrl": "https://x.com/acmecorp",
    "primaryLinkLabel": "Twitter",
    "secondaryLinks": []
  },
  "introVideo": {
    "primaryLinkUrl": "https://youtube.com/watch?v=example",
    "primaryLinkLabel": "Company Overview",
    "secondaryLinks": []
  },
  "industry": "Technology",
  "employees": 150,
  "idealCustomerProfile": true,
  "tagline": "Innovation at its finest",
  "visaSponsorship": false,
  "workPolicy": ["ON_SITE", "HYBRID"],
  "annualRecurringRevenue": {
    "amountMicros": 500000000000,
    "currencyCode": "USD"
  },
  "address": {
    "addressStreet1": "123 Main Street",
    "addressStreet2": "Suite 200",
    "addressCity": "New York",
    "addressState": "New York",
    "addressPostcode": "10001",
    "addressCountry": "United States",
    "addressLat": 40.7128,
    "addressLng": -74.0060
  },
  "accountOwnerId": "uuid-of-workspace-member"
}

Required Fields

name (string) — Company name

Optional Fields

domainName (LINKS) — Company website { primaryLinkUrl, primaryLinkLabel, secondaryLinks: [] }
linkedinLink (LINKS) — LinkedIn page
xLink (LINKS) — X/Twitter profile
introVideo (LINKS) — Intro video URL
industry (string) — Business sector
employees (number) — Employee count (min: 1)
idealCustomerProfile (boolean) — ICP match
tagline (string) — Company tagline
visaSponsorship (boolean) — Offers visa sponsorship
workPolicy (string[]) — Values: ON_SITE, HYBRID, REMOTE_WORK
annualRecurringRevenue (CURRENCY) — { amountMicros, currencyCode }
address (ADDRESS) — Full address object
accountOwnerId (UUID) — Account owner

Update Company

Send only fields to update. Same field shapes as create. name is also updatable.

Get Company

List Companies

GET /rest/companies?limit=60&order_by=name[AscNullsLast]

GET /rest/companies?limit=60&order_by=name[AscNullsLast]

GET /rest/companies?limit=60&order_by=name[AscNullsLast]

Delete Company

Search Patterns

By Name (GraphQL + REST)

Step 1 — GraphQL:

{
  "query": "query Search($searchInput: String!) { search(searchInput: $searchInput, includedObjectNameSingulars: [\"company\"], limit: 5) { edges { node { recordId objectNameSingular label imageUrl } } } }",
  "variables": { "searchInput": "Acme" }
}

{
  "query": "query Search($searchInput: String!) { search(searchInput: $searchInput, includedObjectNameSingulars: [\"company\"], limit: 5) { edges { node { recordId objectNameSingular label imageUrl } } } }",
  "variables": { "searchInput": "Acme" }
}

{
  "query": "query Search($searchInput: String!) { search(searchInput: $searchInput, includedObjectNameSingulars: [\"company\"], limit: 5) { edges { node { recordId objectNameSingular label imageUrl } } } }",
  "variables": { "searchInput": "Acme" }
}

POST to https://app.usedalil.ai/graphql

Step 2 — Fetch full records:

GET /rest/companies?filter=id[in]:[recordId1,recordId2]

GET /rest/companies?filter=id[in]:[recordId1,recordId2]

GET /rest/companies?filter=id[in]:[recordId1,recordId2]

By LinkedIn (REST)

GET /rest/companies?filter=linkedinLink.primaryLinkUrl[ilike]

GET /rest/companies?filter=linkedinLink.primaryLinkUrl[ilike]

GET /rest/companies?filter=linkedinLink.primaryLinkUrl[ilike]

By Domain (REST)

GET /rest/companies?filter=domainName.primaryLinkUrl[ilike]

GET /rest/companies?filter=domainName.primaryLinkUrl[ilike]

GET /rest/companies?filter=domainName.primaryLinkUrl[ilike]

Filter Examples

# Companies in technology industry
filter=industry[ilike]:technology

# Companies with 50+ employees
filter=employees[gte]:50

# Companies matching ICP
filter=idealCustomerProfile[eq]:true

# Companies with ARR over $100K
filter=annualRecurringRevenue.amountMicros[gt]:100000000000

# Companies without an owner
filter=accountOwnerId[is]

# Companies in technology industry
filter=industry[ilike]:technology

# Companies with 50+ employees
filter=employees[gte]:50

# Companies matching ICP
filter=idealCustomerProfile[eq]:true

# Companies with ARR over $100K
filter=annualRecurringRevenue.amountMicros[gt]:100000000000

# Companies without an owner
filter=accountOwnerId[is]

# Companies in technology industry
filter=industry[ilike]:technology

# Companies with 50+ employees
filter=employees[gte]:50

# Companies matching ICP
filter=idealCustomerProfile[eq]:true

# Companies with ARR over $100K
filter=annualRecurringRevenue.amountMicros[gt]:100000000000

# Companies without an owner
filter=accountOwnerId[is]

Gotchas

ARR is in micros — $500,000 = 500000000000 micros. Multiply actual amount by 1,000,000.
Link fields need full structure — Domain, LinkedIn, X, and intro video all use { primaryLinkUrl, primaryLinkLabel, secondaryLinks: [] }.
Work policy values are UPPER_SNAKE_CASE — Use ON_SITE, HYBRID, REMOTE_WORK.
Address is a flat object — All address fields are at the same level (no nesting), prefixed with address.
Domain filter uses nested path — Use domainName.primaryLinkUrl[ilike]:value.
GraphQL search returns IDs only — Follow up with GET /rest/companies?filter=id[in]:[id1,id2] to fetch full records.
Empty fields are auto-cleaned — Null/undefined/empty values are stripped before sending.
GraphQL limit must be hardcoded, not a variable — Passing $limit: Int as a variable causes a type error (Int vs Int!). Inline the limit directly in the query string: limit: 5.
Use depth=1 for full company fetch, not depth=2 — depth=2 returns extremely large payloads (500KB+) by loading all nested relations. depth=1 is sufficient to get the company plus its direct relations (account owner, opportunities, people, etc.).
URL-encode GET filter params — Filter strings contain special characters ([, ], :) that break manually constructed URLs. Use URL encoding when making requests (e.g., curl -G --data-urlencode "filter=...").

On this page

Headings appear here in Preview.

On this page

Headings appear here in Preview.