List Fields

Lists all available fields for contacts and companies.

GET /fields

List Fields

cURL

curl --request GET \
  --url https://api.lemlist.com/api/fields \
  --header 'Authorization: Basic <encoded-value>'

200

{
  "success": true,
  "data": {
    "contact": [
      {
        "name": "email",
        "label": "Email",
        "type": "text",
        "source": "default"
      },
      {
        "name": "firstName",
        "label": "First name",
        "type": "text",
        "source": "default"
      },
      {
        "name": "revenue",
        "label": "Annual Revenue",
        "type": "number",
        "source": "custom"
      },
      {
        "name": "leadStatus",
        "label": "leadStatus",
        "type": "text",
        "source": "crm_synced",
        "crmField": "hs_lead_status"
      }
    ],
    "company": [
      {
        "name": "linkedinUrl",
        "label": "LinkedIn URL",
        "type": "text",
        "source": "default"
      },
      {
        "name": "industry",
        "label": "Industry",
        "type": "text",
        "source": "custom"
      }
    ]
  }
}

Returns all available fields for contacts and companies, grouped by entity. Use this endpoint to discover field names before upserting contacts or companies.

Field sources

Source	Description
default	Built-in fields available on every account (e.g. email, firstName, phone)
custom	Custom fields created by your team
crm_synced	Fields from your connected CRM’s field mapping configuration

CRM-synced fields

When your team has a CRM connected, fields with source: "crm_synced" reflect the field mapping configured between lemlist and your CRM. These fields include an additional crmField property containing the corresponding field name on the CRM side.

If no CRM is connected, no crm_synced fields are returned.

Filtering

Use query parameters to narrow results:

• entity — return fields for a single entity (contact or company)
• source — return only fields from a specific source (default, custom, or crm_synced)

Both filters can be combined.

Authorizations

Authorization · string · header · required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Query Parameters

entity · enum<string>

Filter by entity type

Available options: contact, company

source · enum<string>

Filter by field source

Available options: default, custom, crm_synced

Response

200

application/json

Success

success · boolean

data · object

Show child attributes