Contact address Workflow Tasks

Contact address tasks are used to create, update, and delete Contact addresss.

Create Contact address

task: "ContactAddress/Create@1"
name: createContactAddress
inputs: 
  values:
    organizationId: "{{ organizationId }}"
    addressLine: "{{ addressLine }}"
    addressLine2: "{{ addressLine2 }}"
    addressType: "{{ addressType }}"
    cityName: "{{ cityName }}"
    contactId: "{{ contactId }}"
    countryCode: "{{ countryCode }}"
    customValues: "{{ customValues }}"
    location: "{{ location }}"
    postalCode: "{{ postalCode }}"
    stateCode: "{{ stateCode }}"
outputs:
  - name: contactAddress
    mapping: "contactAddress"

Get Contact address

task: "ContactAddress/Get@1"
name: getContactAddress
inputs: 
  contactAddressId: "123"

outputs:
  - name: contactAddress
    mapping: "contactAddress"

Update Contact address

task: "ContactAddress/Update@1"
name: updateContactAddress
inputs: 
  contactAddressId: "123"
  values: 
    addressLine: "{{ addressLine }}"
    addressLine2: "{{ addressLine2 }}"
    addressType: "{{ addressType }}"
    cityName: "{{ cityName }}"
    contactId: "{{ contactId }}"
    countryCode: "{{ countryCode }}"
    customValues: "{{ customValues }}"
    location: "{{ location }}"
    postalCode: "{{ postalCode }}"
    stateCode: "{{ stateCode }}"

Delete Contact address

task: "ContactAddress/Delete@1"
name: deleteContactAddress
inputs: 
  contactAddressId: "123"

Import Contact Addresses

task: "ContactAddress/Import@1"
name: importContactAddresses
inputs:
  organizationId: "{{ organizationId }}"
  contactId: "{{ contactId }}"
  fileUrl: "{{ fileUrl }}"
  fileType: "Csv"
  matchByFields:
    - AddressLine
    - AddressLine2
    - CityName
    - CountryCode
    - PostalCode
    - StateCode
  columnMappings:
    Address: AddressLine
    City: CityName
outputs:
  - name: result
    mapping: "result"

ContactAddress/Import@1 bulk imports contact addresses from CSV/Excel-style data. Imports are scoped to one organizationId and contactId, default new rows to AddressType.Other, and support upsert matching.

Matching behavior: if the row includes ContactAddressId, the import matches by ID first. Otherwise it uses matchByFields, defaulting to address line, city, country, postal code, and state fields. Missing optional match fields are treated as null instead of failing the row.

Supported aliases and special fields: City is normalized to CityName; StateCode is used directly, or StateName is resolved case-insensitively. Rows without country or any state hint are skipped. Longitude + Latitude populate the address location.

Example Contact address Workflow

workflow:
  name: "Contact address / Create ContactAddress Example Workflow" 
  description: "Create Contact address Example Workflow"
  version: "1.0" 
  executionMode: "Sync"

inputs:
  - name: "organizationId"
    type: "Organization"
    displayName: "Organization id"
    description: "Organization id"
    multiple: false
    required: true
    defaultValue: ""
    additionalProperties:
      visible: true
      mapping: "contactAddress.organizationId"
  - name: "addressLine"
    type: "string"
    displayName: "Address line"
    description: "Address line"
    multiple: false
    required: true
    defaultValue: ""
    additionalProperties:
      visible: true
      mapping: "contactAddress.addressLine"
  - name: "addressLine2"
    type: "string"
    displayName: "Address line 2"
    description: "Address line 2"
    multiple: false
    required: false
    defaultValue: ""
    additionalProperties:
      visible: true
      mapping: "contactAddress.addressLine2"
  - name: "addressType"
    type: "AddressType"
    displayName: "Address type"
    description: "Address type"
    multiple: false
    required: true
    defaultValue: ""
    additionalProperties:
      visible: true
      mapping: "contactAddress.addressType"
  - name: "cityName"
    type: "string"
    displayName: "City name"
    description: "City name"
    multiple: false
    required: false
    defaultValue: ""
    additionalProperties:
      visible: true
      mapping: "contactAddress.cityName"
  - name: "contactId"
    type: "Contact"
    displayName: "Contact id"
    description: "Contact id"
    multiple: false
    required: true
    defaultValue: ""
    additionalProperties:
      visible: true
      mapping: "contactAddress.contactId"
  - name: "countryCode"
    type: "Country"
    displayName: "Country code"
    description: "Country code"
    multiple: false
    required: false
    defaultValue: ""
    additionalProperties:
      visible: true
      mapping: "contactAddress.countryCode"
  - name: "customValues"
    type: "string,string"
    displayName: "Custom values"
    description: "Custom values"
    multiple: false
    required: false
    defaultValue: ""
    additionalProperties:
      visible: true
      mapping: "contactAddress.customValues"
  - name: "location"
    type: "Point"
    displayName: "Location"
    description: "Location"
    multiple: false
    required: false
    defaultValue: ""
    additionalProperties:
      visible: true
      mapping: "contactAddress.location"
  - name: "postalCode"
    type: "string"
    displayName: "Postal code"
    description: "Postal code"
    multiple: false
    required: false
    defaultValue: ""
    additionalProperties:
      visible: true
      mapping: "contactAddress.postalCode"
  - name: "stateCode"
    type: "State"
    displayName: "State code"
    description: "State code"
    multiple: false
    required: false
    defaultValue: ""
    additionalProperties:
      visible: true
      mapping: "contactAddress.stateCode"

outputs:
  - name: contactAddress
    mapping: "createContactAddressActivity.createContactAddress.contactAddress"

activities:
  - name: "createContactAddressActivity"
    description: "Create Contact address"
    steps:
      - task: "ContactAddress/Create@1"
        name: createContactAddress
        inputs: 
          contactAddress:
            organizationId: "{{ organizationId }}"
            addressLine: "{{ addressLine }}"
            addressLine2: "{{ addressLine2 }}"
            addressType: "{{ addressType }}"
            cityName: "{{ cityName }}"
            contactId: "{{ contactId }}"
            countryCode: "{{ countryCode }}"
            customValues: "{{ customValues }}"
            location: "{{ location }}"
            postalCode: "{{ postalCode }}"
            stateCode: "{{ stateCode }}"
        outputs:
          - name: contactAddress
            mapping: "contactAddress"
  - name: "getContactAddressActivity"
    description: "Get ContactAddress"
    steps:
      - task: "ContactAddress/Get@1"
        name: getContactAddress
        inputs: 
          contactAddressId: "{{ createContactAddressActivity.createContactAddress.contactAddress.contactAddressId }}"
        outputs:
          - name: contactAddressFromGet
            mapping: "contactAddress"
  - name: "updateContactAddressActivity"
    description: "Update ContactAddress"
    steps:
      - task: "ContactAddress/Update@1"
        name: updateContactAddress
        inputs: 
          organizationId: "{{ getContactAddressActivity.getContactAddress.contactAddress.organizationId }}"
          contactAddressId: "{{ getContactAddressActivity.getContactAddress.contactAddress.contactAddressId }}"
          contactAddress:
            addressLine: "{{ addressLine }}"
            addressLine2: "{{ addressLine2 }}"
            addressType: "{{ addressType }}"
            cityName: "{{ cityName }}"
            contactId: "{{ contactId }}"
            countryCode: "{{ countryCode }}"
            customValues: "{{ customValues }}"
            location: "{{ location }}"
            postalCode: "{{ postalCode }}"
            stateCode: "{{ stateCode }}"
  - name: "deleteContactAddressActivity"
    description: "Delete ContactAddress"
    steps:
      - task: "ContactAddress/Delete@1"
        name: deleteContactAddress
        inputs: 
          organizationId: "{{ getContactAddressActivity.getContactAddress.contactAddress.organizationId }}"
          contactAddressId: "{{ getContactAddressActivity.getContactAddress.contactAddress.contactAddressId }}"