topic Re: Cannot set a contact's marketing status via API in APIs & Integrations

Cannot set a contact's marketing status via API

dsecareanu — Sat, 16 Jan 2021 07:09:02 GMT

Hi there,

We're trying to update the contact marketing status for existing contacts in HubSpot via APi (that integrations is configured in settings to create marketing contacts) and the command we use is (integrated in a bigger sync):

{

"property": "hs_marketable_status",

"value": "true"

}

The response error we get is:

{

"validationResults": [

{

"isValid": false,

"message": ""hs_marketable_status" is a read only property; its value cannot be set.",

"error": "READ_ONLY_VALUE",

"name": "hs_marketable_status"

}

"status": "error",

"message": "Property values were not valid",

"correlationId": "f11f0def-0e2a-4261-91c2-17d6cec509bb"

}

Any ideas how we can update the marketing status on contacts via API?

Thank you!

Re: Cannot set a contact's marketing status via API

quentin_lamamy — Thu, 21 Jan 2021 17:27:22 GMT

Hi @dsecareanu ,

You are trying to edit an internal field, you can't edit it, you can only read it.

Re: Cannot set a contact's marketing status via API

dsecareanu — Mon, 18 Jan 2021 17:44:10 GMT

Thank you @quentin_lamamy - question though: how can the marketable status pe updated for contacts except the standard configured settings (API & forms)?

Re: Cannot set a contact's marketing status via API

quentin_lamamy — Thu, 21 Jan 2021 17:27:07 GMT

I'm not sure to understand your question

Re: Cannot set a contact's marketing status via API

dsecareanu — Tue, 19 Jan 2021 07:55:14 GMT

If we want to change a contact's marketable status (i.e. if it's a marketable or non-marketable contact) how do we go about it via API (if the property is read only)?

Re: Cannot set a contact's marketing status via API

quentin_lamamy — Tue, 19 Jan 2021 08:12:21 GMT

You just can't edit this field

message": "hs_marketable_status is a read only property its value cannot be set."

@dennisedson is there something under the hood to by pass restriction (even if it seems a bad idea to edit internal field)

Re: Cannot set a contact's marketing status via API

dsecareanu — Thu, 21 Jan 2021 14:50:38 GMT

I understand that the field is not editable, but contacts can be toggled into marketing or non-marketing contacts through API integrations and form submissions (there are settings that allow you to toggle which API integration or type of form submissions creates a marketable or non-marketable contact) but something is not making sense.

In the end I figured it out going through the field description:

This unique identifier will be used when syncing with integration partners. Once created it can't be edited.

It seems it can be created, but it cannot be edited once created... which is a strange limitation because we have use cases in which a contact is created through an API integration as a marketing contact (or non marketing contact) and then we want to update the status of this contact through another API integration based on additional information we collect on that respective contact.

To give a concrete example:

We use Call Tracking Metrics to create contacts from phone calls and since we do not have an email address at the time of the call, the contact is created with a 12345678@hubspot.com temporary email address (which is, of course, non marketable to).

Once the call (handled by the sales) is done, that contact is updated in another CRM platform with a name, proper email address and other information and that data is passed to HubSpot via API by matching the phone number and updating the email and other relevant contact properties.

Now we have 2 cases: the contact was junk and it doesn't get an update, so it's fine that the @hubspot.com email is non marketable, but also the contact was valid and data is updated, but now it's marketing status cannot be updated because the contact has already been created by another API integration...

How can we go about this to automate this unless we use Pro and workflows (as only the upgrade from Starter seems to be the answer)? Thanks.

Re: Cannot set a contact's marketing status via API

dennisedson — Tue, 19 Jan 2021 19:27:10 GMT

@quentin_lamamy

Nope. this one is read only.

Workflows is the best solution now. I brought this up recently. @TimMunro also asked this and I suggested creating an idea for it because I agree that the API request should be able to accomplish this.

@dsecareanu , if Tim hasn't created the idea, please do and we can get the upvotes started.

Re: Cannot set a contact's marketing status via API

dsecareanu — Thu, 21 Jan 2021 14:44:06 GMT

I've created the idea here, so please upvote it:

https://community.hubspot.com/t5/HubSpot-Ideas/Please-allow-marketing-contact-status-to-be-updated-via-API/idi-p/401913#M72587

Thanks!

Re: Cannot set a contact's marketing status via API

phena109 — Sat, 05 Mar 2022 12:31:48 GMT

I haven't tested it but this article actually said we can change that via workflow. So while indirect we can have 2 simple workflows ready. One for making marketing contact and one for making non-marketing contact. When needed, enrol the contact to that workflow and let hubspot system change it for us. Can anyone check if that's possible?

Re: Cannot set a contact's marketing status via API

kenshvetz — Tue, 29 Nov 2022 16:53:30 GMT

Yes, why can't we simply edit this field in a list upload? (FYI we use a 3rd party dedupe/data hygiene tool Insycle to import lists into HubSpot so same issue there as well -- even though it lets you select Marketing Contact Status as a field and set the value, HubSpot throws the same error on upload). HubSpot, please fix!!

Re: Cannot set a contact's marketing status via API

DavidVoigt — Wed, 31 May 2023 07:46:18 GMT

- Create a form in the HubSpot backend. Make sure it is set to create marketing contacts.
- Use this endpoint to submit the form

You can use the API to trigger a form submission. Use this endpoint:
https://api.hsforms.com/submissions/v3/integration/submit

Docs

Re: Cannot set a contact's marketing status via API

MGotfryd — Sun, 02 Jun 2024 15:53:34 GMT

What works for my case is to go to Settings -> Account Setup -> Integrations -> Marketing Contacts

and enable my connected app to create marketing contacts. When you use the normal API, they will automatically have this checked.

Re: Cannot set a contact's marketing status via API

BBiales — Mon, 09 Mar 2026 14:09:41 GMT

I have an idea but I haven't tried it yet.
If we create our own Property, let's call it "My Marketing Contact", with two values TRUE and FALSE, you could have one or two workflows watching this property on contacts, and when set TRUE, the workflow can set the HS marketing contact on and when FALSE, set as a non-marketing contact.
If NULL then it is left however HS sets it (via a form for instance, it might be on, via Import API, it might be off)

But if your import (via file or API, and set your new property to True or False, the workflow will kick in and do what you ask.

Re: Cannot set a contact's marketing status via API

IFly0 — Wed, 11 Mar 2026 22:09:37 GMT

is there any update on this? THe only want to do this is to indirectly submit a form through API??

Re: Cannot set a contact's marketing status via API

STierney — Thu, 12 Mar 2026 02:15:45 GMT

Hey @IFly0,

Thanks for following up here!

While it looks like this has not been a feature to be rolled out by the team, it does appear that there is a lot of support for it in this post in our Ideas Forum:

https://community.hubspot.com/t5/HubSpot-Ideas/Please-allow-marketing-contact-status-to-be-updated-via-API/idi-p/401913#M72587

I highly recomend upvoting it and expanding on it with any other you details you'd like to add!

Shane, Senior Community Moderator