> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.spreadly.app/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Map Custom Lead Fields to Your CRM


Want to sync not just the default lead details (like name, contact details, job info) but also your custom fields from Spreadly to your CRM? No problem! In this guide, we'll show you step by step how to map custom lead fields, including how to grab the right API key from your CRM system (specifically for HubSpot and Pipedrive). 

| Note: If your CRM field is a dropdown/select field and your custom field in Spreadly is also a select, we'll automatically pull the predefined options from your CRM. No extra setup needed. Just map and go!

|| Be sure to use the **internal name/API key**, *not* the display label of the field. Otherwise, syncing won't work.



## 1. Create or Edit a Custom Lead Field in Spreadly

First, head to the **Custom Attributes** section in your Spreadly dashboard.

![Go to "Custom Attributes"](https://storage.crisp.chat/users/helpdesk/website/-/6/1/b/6/61b64ab3334f9c0/screenshot-17112025-um-104246-_xg6wf4.png =329xauto)

When creating or editing your custom attribute, you'll see a `CRM field` input. This is where you'll paste the CRM field's API key (sometimes called "internal name" or "field key").

![CRM field entry in Spreadly](https://storage.crisp.chat/users/helpdesk/website/-/6/1/b/6/61b64ab3334f9c0/screenshot-17112025-um-104332-_1kmlbu9.png =419xauto)



## 2. How to Find the API Key for Your CRM Field

### HubSpot

Follow these steps to get the internal name (API key) of your HubSpot property:

1. Open a Contact and Click "Actions" → "View all properties"  
   ![Actions > View all properties](https://storage.crisp.chat/users/helpdesk/website/-/6/1/b/6/61b64ab3334f9c0/screenshot-17112025-um-104447-_130xdh8.png =548xauto)

2. Search or Browse for Your Property, Then Click "Manage properties"  
   ![Search property and manage](https://storage.crisp.chat/users/helpdesk/website/-/6/1/b/6/61b64ab3334f9c0/screenshot-17112025-um-104454-_1xpe243.png =585xauto)

3. Find the Property and Click It  
   ![List of properties](https://storage.crisp.chat/users/helpdesk/website/-/6/1/b/6/61b64ab3334f9c0/screenshot-17112025-um-104521-_ok4jvj.png =669xauto)

4. Copy the "Internal name". That's your API key!  
   ![Internal name shown](https://storage.crisp.chat/users/helpdesk/website/-/6/1/b/6/61b64ab3334f9c0/screenshot-17112025-um-104532-_qpn79p.png =660xauto)

  


### Pipedrive

1. Go to "Data fields" in Your Company Settings  
   ![Pipedrive Data Fields](https://storage.crisp.chat/users/helpdesk/website/-/6/1/b/6/61b64ab3334f9c0/screenshot-17112025-um-104640-_qzatf8.png =235xauto)

2. Find Your Custom Field, Click the Three Dots, and Select "Copy API key"  
   ![Copy API key in Pipedrive](https://storage.crisp.chat/users/helpdesk/website/-/6/1/b/6/61b64ab3334f9c0/screenshot-17112025-um-104652-_5u3dm7.png =368xauto)



## 3. Paste the API Key into Spreadly

Head back to the custom field in Spreadly and paste the copied API key into the `CRM field` input.

That's it! Your custom Spreadly field will now sync directly with your CRM's custom property.


| In case your current CRM platform is not supported, let us know. We're always looking to enhance our integrations.