Create Or Update Contact with Constant Contact API

Pipedream makes it easy to connect APIs for Constant Contact and 3,000+ other apps remarkably fast.

Trigger workflow on

HTTP requests, schedules and app events

Next, do this

Create Or Update Contact with the Constant Contact API

No credit card required

▶

Watch us build a workflow

8 min

Watch now ➜

Trusted by 1,000,000+ developers from startups to Fortune 500 companies

Developers ♥ Pipedream

Getting Started#

Create a workflow to Create Or Update Contact with the Constant Contact API. When you configure and deploy the workflow, it will run on Pipedream's servers 24x7 for free.

Configure the Create Or Update Contact action
1. Connect your Constant Contact account
2. Configure Email Address
3. Optional- Configure First Name
4. Optional- Configure Last Name
5. Optional- Configure Job Title
6. Optional- Configure Company Name
7. Optional- Configure Phone Number
8. Select one or more List Membership
9. Optional- Configure Custom Fields
10. Optional- Configure Anniversary
11. Optional- Select a Address Type
12. Optional- Configure Address Street
13. Optional- Configure Address City
14. Optional- Configure Address State
15. Optional- Configure Address Postal Code
16. Optional- Configure Address Country
17. Optional- Configure SMS Address
18. Optional- Configure Dial Code
19. Optional- Configure Country Code
20. Optional- Configure SMS Channel Consents
Select a trigger to run your workflow on HTTP requests, schedules or app events
Deploy the workflow
Send a test event to validate your setup
Turn on the trigger

Details#

This is a pre-built, source-available component from Pipedream's GitHub repo. The component is developed by Pipedream and the community, and verified and maintained by Pipedream.

To contribute an update to an existing component or create a new component, create a PR on GitHub. If you're new to Pipedream component development, you can start with quickstarts for trigger span and action development, and then review the component API reference.

Create Or Update Contact on Constant Contact

Description:Create a new contact or update an existing one based on their email address. This method is appropriate when a contact has given explicit permission to receive emails. [See the documentation](https://developer.constantcontact.com/api_reference/index.html#tag/Contacts/operation/createOrUpdateContact)

Version:0.0.1

Key:constant_contact-create-or-update-contact

View on GitHub

Code#

import { ADDRESS_TYPE_OPTIONS } from "../../common/constants.mjs";
import { parseObject } from "../../common/utils.mjs";
import constantContact from "../../constant_contact.app.mjs";

export default {
  key: "constant_contact-create-or-update-contact",
  name: "Create Or Update Contact",
  version: "0.0.1",
  annotations: {
    destructiveHint: false,
    openWorldHint: true,
    readOnlyHint: false,
  },
  description: "Create a new contact or update an existing one based on their email address. This method is appropriate when a contact has given explicit permission to receive emails. [See the documentation](https://developer.constantcontact.com/api_reference/index.html#tag/Contacts/operation/createOrUpdateContact)",
  type: "action",
  props: {
    constantContact,
    emailAddress: {
      propDefinition: [
        constantContact,
        "emailAddress",
      ],
      description: "The email address for the contact. This method identifies each unique contact using their email address. If the email address exists in the account, this method updates the contact. If the email address is new, this method creates a new contact",
    },
    firstName: {
      propDefinition: [
        constantContact,
        "firstName",
      ],
      optional: true,
    },
    lastName: {
      propDefinition: [
        constantContact,
        "lastName",
      ],
      optional: true,
    },
    jobTitle: {
      propDefinition: [
        constantContact,
        "jobTitle",
      ],
      optional: true,
    },
    companyName: {
      type: "string",
      label: "Company Name",
      description: "The name of the company where the contact works",
      optional: true,
    },
    phoneNumber: {
      type: "string",
      label: "Phone Number",
      description: "The phone number of the contact",
      optional: true,
    },
    listMemberships: {
      propDefinition: [
        constantContact,
        "listMemberships",
      ],
      description: "Array of lists to which the contact is being subscribed, up to a maximum of 50. At least one list is required",
    },
    customFields: {
      type: "string[]",
      label: "Custom Fields",
      description: "The custom fields you want to add to the contact as an array of up to 50 custom field objects",
      optional: true,
    },
    anniversary: {
      type: "string",
      label: "Anniversary",
      description: "The anniversary date for the contact. For example, this value could be the date when the contact first became a customer of an organization in Constant Contact. Valid date formats are MM/DD/YYYY, M/D/YYYY, YYYY/MM/DD, YYYY/M/D, YYYY-MM-DD, YYYY-M-D,M-D-YYYY, or M-DD-YYYY",
      optional: true,
    },
    addressType: {
      type: "string",
      label: "Address Type",
      description: "The type of street address for the contact",
      options: ADDRESS_TYPE_OPTIONS,
      optional: true,
    },
    addressStreet: {
      type: "string",
      label: "Address Street",
      description: "The number and street of the contact's address",
      optional: true,
    },
    addressCity: {
      type: "string",
      label: "Address City",
      description: "The name of the city for the contact's address",
      optional: true,
    },
    addressState: {
      type: "string",
      label: "Address State",
      description: "The name of the state or province for the contact's address",
      optional: true,
    },
    addressPostalCode: {
      type: "string",
      label: "Address Postal Code",
      description: "The zip or postal code for the contact's address",
      optional: true,
    },
    addressCountry: {
      type: "string",
      label: "Address Country",
      description: "The name of the country for the contact's address",
      optional: true,
    },
    smsAddress: {
      type: "string",
      label: "SMS Address",
      description: "The contact's SMS-capable phone number, excluding the country code",
      optional: true,
    },
    dialCode: {
      type: "string",
      label: "Dial Code",
      description: "The dial code the country uses. For example, use `1` for the United States dial code",
      optional: true,
    },
    countryCode: {
      type: "string",
      label: "Country Code",
      description: "The two-digit code that identifies the country",
      optional: true,
    },
    smsChannelConsents: {
      type: "string[]",
      label: "SMS Channel Consents",
      description: "An array of up to 50 objects that describe the contact's SMS channel consents. [See the documentation](https://developer.constantcontact.com/api_reference/index.html#tag/Contacts/operation/createOrUpdateContact) for more information",
      optional: true,
    },
  },
  async run({ $ }) {
    const data = {
      email_address: this.emailAddress,
      first_name: this.firstName,
      last_name: this.lastName,
      job_title: this.jobTitle,
      company_name: this.companyName,
      phone_number: this.phoneNumber,
      list_memberships: parseObject(this.listMemberships),
      custom_fields: parseObject(this.customFields),
      anniversary: this.anniversary,
      street_address: {
        kind: this.addressType,
        street: this.addressStreet,
        city: this.addressCity,
        state: this.addressState,
        postal_code: this.addressPostalCode,
        country: this.addressCountry,
      },
    };

    const smsChannel = {};
    if (this.smsAddress) {
      smsChannel.sms_address = this.smsAddress;
    }
    if (this.dialCode) {
      smsChannel.dial_code = this.dialCode;
    }
    if (this.countryCode) {
      smsChannel.country_code = this.countryCode;
    }
    if (this.smsChannelConsents) {
      smsChannel.sms_channel_consents = parseObject(this.smsChannelConsents);
    }
    if (Object.keys(smsChannel).length > 0) {
      data.sms_channel = smsChannel;
    }

    const response = await this.constantContact.createOrUpdateContact({
      $,
      data,
    });

    $.export("$summary", `Successfully **${response.action}** contact with ID: \`${response.contact_id}\``);
    return response;
  },
};

Configuration#

This component may be configured based on the props defined in the component code. Pipedream automatically prompts for input values in the UI and CLI.

Label	Prop	Type	Description
Constant Contact	`constantContact`	`app`	This component uses the Constant Contact app.
Email Address	`emailAddress`	`string`	The email address for the contact. This method identifies each unique contact using their email address. If the email address exists in the account, this method updates the contact. If the email address is new, this method creates a new contact
First Name	`firstName`	`string`	The first name of the contact.
Last Name	`lastName`	`string`	The last name of the contact.
Job Title	`jobTitle`	`string`	The job title of the contact.
Company Name	`companyName`	`string`	The name of the company where the contact works
Phone Number	`phoneNumber`	`string`	The phone number of the contact
List Membership	`listMemberships`	`string[]`	Select a value from the drop down menu.
Custom Fields	`customFields`	`string[]`	The custom fields you want to add to the contact as an array of up to 50 custom field objects
Anniversary	`anniversary`	`string`	The anniversary date for the contact. For example, this value could be the date when the contact first became a customer of an organization in Constant Contact. Valid date formats are MM/DD/YYYY, M/D/YYYY, YYYY/MM/DD, YYYY/M/D, YYYY-MM-DD, YYYY-M-D,M-D-YYYY, or M-DD-YYYY
Address Type	`addressType`	`string`	Select a value from the drop down menu:`{ "label": "Home", "value": "home" }{ "label": "Work", "value": "work" }{ "label": "Other", "value": "other" }`
Address Street	`addressStreet`	`string`	The number and street of the contact's address
Address City	`addressCity`	`string`	The name of the city for the contact's address
Address State	`addressState`	`string`	The name of the state or province for the contact's address
Address Postal Code	`addressPostalCode`	`string`	The zip or postal code for the contact's address
Address Country	`addressCountry`	`string`	The name of the country for the contact's address
SMS Address	`smsAddress`	`string`	The contact's SMS-capable phone number, excluding the country code
Dial Code	`dialCode`	`string`	The dial code the country uses. For example, use `1` for the United States dial code
Country Code	`countryCode`	`string`	The two-digit code that identifies the country
SMS Channel Consents	`smsChannelConsents`	`string[]`	An array of up to 50 objects that describe the contact's SMS channel consents. See the documentation for more information

Authentication#

Constant Contact uses OAuth authentication. When you connect your Constant Contact account, Pipedream will open a popup window where you can sign into Constant Contact and grant Pipedream permission to connect to your account. Pipedream securely stores and automatically refreshes the OAuth tokens so you can easily authenticate any Constant Contact API.

Pipedream requests the following authorization scopes when you connect your account:

account_readaccount_updatecontact_datacampaign_dataoffline_access

About Constant Contact#

We deliver for small businesses and nonprofits with the right tools to simplify and amplify your digital marketing and generate powerful results.

More Ways to Use Constant Contact#

Triggers#

New Account Created from the Constant Contact API

Emit new event when a new email account is created.

Try it

New Contact Added from the Constant Contact API

Emit new event when a new contact is created.

Try it

Actions#

Add An Account Email Address with the Constant Contact API

Add a new email address to your Constant Contact account. This action sends a confirmation email to the new address. Once confirmed, the email address can be used in the from_email and reply_to_email fields of your email campaigns. See the documentation

Try it

Add Contact with the Constant Contact API

Add a single contact. See the documentation

Try it

Create Email Campaign with the Constant Contact API

Create a new email campaign. See the documentation

Try it

Remove Contact with the Constant Contact API

Delete a specific contact identified by contact_id. See the documentation

Try it

Update Contact with the Constant Contact API

Update an existing contact. See the documentation