HubSpot Knowledge Base

Manage marketing contacts settings for your integrations

Written by Public API | Jan 1, 1970 12:00:00 AM

In HubSpot, only contacts tagged as marketing contacts can receive marketing emails and be targeted with ads. If you use connected apps in HubSpot to create contacts, you can automatically set new contacts as marketing contacts. Apps in HubSpot can be connected via API key or OAuth, which includes apps from the app marketplace. All new marketing contacts will count towards your billable contact tier limit.

Please note: you must have Marketing contacts access permissions to set your contacts’ marketing status.

Set contacts created by API key apps as marketing contacts

Follow these steps to set contacts created by apps connected to your account via API key authentication as marketing contacts. Only contacts created after the toggle has been switched on will be created as marketing contacts.

  • In the left sidebar menu, navigate to Integrations, then click Marketing contacts.
  • In the Your HubSpot API key section, click to toggle the HubSpot API key switch on.

Please note: only contacts created after the toggle has been switched on will be created as marketing contacts. Learn how to set existing contacts as marketing contacts manually in bulk or via workflows
 

It is not possible to modify the Marketing contact status property using HubSpot’s API endpoints; however, you can look up the status of a record using the Read Contacts endpoint and hs_marketable_status as the internal value for the Marketing contact status property.

Set contacts created by oAuth or app marketplace apps as marketing contacts

You can decide which apps connected to your account via OAuth authentication will sync contacts as marketing contacts. This includes apps connected from the HubSpot App Marketplace. Only contacts created after the toggle has been switched on will be created as marketing contacts.

  • In the left sidebar menu, navigate to Integrations, then click Marketing contacts
  • In the Your connected apps section, you’ll see all connected apps in your portal. 
  • Click to toggle the switch on for any apps that you want to sync contacts to HubSpot as marketing contacts.

Please note:

  • Only contacts created after the toggle has been switched on will be created as marketing contacts. Learn how to set existing contacts as marketing contacts manually in bulk or via workflows.
  • All apps connected to your portal will be listed in the Your connected apps section, even if they do not create contacts. Turning the toggle on for apps that do not create contacts will not impact your marketing contacts.