Which properties are the correct ones to send traffic source data to?

[AZakonek]

Hello great community

I have a question regarding sending traffic source / campaign source into HubSpot on contacts. 

Background: 
We are a SaaS company with our own product and database, where our customers are created and sent to HubSpot (Contact, Company, Deal) via the API.

Currently we don't get the traffic source on these hence they usually are reported as Offline source. We want to change this, and send campaign source, medium etc. into HubSpot together with the objects. 

Question:
Which properties are the correct ones to send the source data to? There is a handfull of different ones that are called something with source, so our developers want to make sure they choose the right ones. We obviosly want it to work in insights and reports the same way it does if a contact converts on a HubSpot form on our website. It is important for us that it will work correctly in reporting and dashboards. 

Is there any documentation on this topic (send traffic source to HubSpot via API) I can direct our developer to?

[kosalaindrasiri · Accepted solution]

Hey @AZakonek,

You can’t directly set HubSpot’s default hs_analytics_* source properties via API, those are auto-populated by HubSpot’s tracking code.

Instead, create custom contact properties like:

• utm_source
• utm_medium

and send those when creating contacts via the API. These can be used in reports, dashboards and lists.

Please refer,

• https://knowledge.hubspot.com/properties/hubspots-default-contact-properties
• https://knowledge.hubspot.com/properties/understand-traffic-source-properties
• https://knowledge.hubspot.com/reports/understand-hubspots-traffic-sources-in-the-traffic-analytics-t...

Hope this will be a help!

Regards,