Action: Update Contact Subscription Preferences

Hubspot Operation

This HubSpot action modifies a contact's email subscription preferences.

Example User Story

I want to update a contact's email subscription preferences so they only receive marketing emails they’ve opted into.

Fields

Field Name	Field Type	Required
contactId	String	Yes
subscriptionId	String	Yes
subscribed	Boolean	Yes

Related Connections

Hubspot

Related Automations

Example link

Code (Apache v2.0): Operation

{
  "handle": "update-contact-subscription-preferences",
  "state": "inDev",
  "meta": {
    "short": "Update Contact Subscription Preferences",
    "description": "Updates the subscription preferences for a contact in HubSpot."
  },
  "input": [
    {
      "name": "contactId",
      "type": "String",
      "required": true,
      "meta": {
        "description": "The ID of the contact to update."
      }
    },
    {
      "name": "subscriptionId",
      "type": "String",
      "required": true,
      "meta": {
        "description": "The ID of the subscription to update."
      }
    },
    {
      "name": "subscribed",
      "type": "Boolean",
      "required": true,
      "meta": {
        "description": "Whether the contact is subscribed."
      }
    }
  ],
  "output": [
    {
      "name": "success",
      "type": "Boolean",
      "selector": ["success"],
      "meta": {
        "description": "Indicates if the update was successful."
      }
    }
  ],
  "steps": [
    {
      "type": "http",
      "http": {
        "method": "PATCH",
        "path": "/marketing/v3/subscriptions/{{contactId}}",
        "headers": {
          "Content-Type": "application/json"
        },
        "bodyTemplate": {
          "value": "{\"subscriptionId\": \"{{subscriptionId}}\", \"subscribed\": {{subscribed}}}",
          "placeholders": [
            {
              "name": "contactId",
              "type": "String",
              "description": "The ID of the contact to update.",
              "required": true
            },
            {
              "name": "subscriptionId",
              "type": "String",
              "description": "The ID of the subscription to update.",
              "required": true
            },
            {
              "name": "subscribed",
              "type": "Boolean",
              "description": "Whether the contact is subscribed.",
              "required": true
            }
          ]
        }
      }
    }
  ]
}