Skip to main content
GET
/
fields
List Fields
curl --request GET \
  --url https://api.lemlist.com/api/fields \
  --header 'Authorization: Basic <encoded-value>'
{
  "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"
      }
    ]
  }
}

Documentation Index

Fetch the complete documentation index at: https://developer.lemlist.com/llms.txt

Use this file to discover all available pages before exploring further.

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

SourceDescription
defaultBuilt-in fields available on every account (e.g. email, firstName, phone)
customCustom fields created by your team
crm_syncedFields 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

Success

​
success
boolean
​
data
object