avanta icon

avanta

Consume avanta API

Actions57

Company - Contact → Create or Update

AI-generated

Overview

This node handles the creation or updating of a company contact within the Avanta API. It is useful for workflows that need to manage contact information for companies, such as adding new contacts or updating existing ones with details like name, email, and additional contact fields. Practical examples include automating CRM updates, syncing contact data from forms, or integrating contact management with other business systems.

Use Case Examples

  1. Creating a new contact with firstname, lastname, and email.
  2. Updating an existing contact's job title and phone number.

Properties

Name Meaning
Request Options Options to customize the API request such as enabling debug mode, ignoring SSL issues, and setting a timeout.
Return to Webhook Whether to return the API response to a webhook, requiring a 'Respond to Webhook' node after this node.
Use Bulk API Whether to use the bulk API for processing multiple items.
Dataflow ID Optional override for the dataflow ID, automatically read from webhook input if not set.
Firstname Firstname of the contact.
Lastname Lastname of the contact.
Email Email address of the contact.
Additional Fields Additional optional fields for the contact such as contact person ID, external ID, fax, job title, mobile, photo, Skype, sort order, store IDs, and telephone.

Output

JSON

  • id - Unique identifier of the created or updated contact.
  • firstname - Firstname of the contact.
  • lastname - Lastname of the contact.
  • email - Email address of the contact.
  • additionalFields
    • contact_person - ID of the contact person.
    • external_id - External identifier for the contact.
    • fax - Fax number of the contact.
    • job_title - Job title of the contact.
    • mobile - Mobile phone number.
    • photo - Photo path or URL for the contact.
    • skype - Skype ID.
    • sort_order - Sort order value.
    • store_ids - Store views associated with the contact.
    • telephone - Telephone number.

Dependencies

  • An API key credential for Avanta API authentication

Troubleshooting

  • Ensure all required fields (firstname, lastname, email) are provided to avoid validation errors.
  • If using the bulk API, verify that the dataflow ID is correctly set or available in the webhook input when triggered via a dataflow profile.
  • Enable debug mode to get detailed API request information if the node fails to execute as expected.
  • If SSL issues occur, consider enabling the option to ignore SSL certificate validation, but be aware of security risks.

Discussion