Aqtos icon

Aqtos

Consume Aqtos API

Actions5

Contact → Create

AI-generated

Summary

Create a new contact in the Aqtos system by sending the specified contact details either as structured form fields or a custom JSON payload.

Inputs

  • Body Input Method (required) — Choose whether to provide contact details through structured form fields or as a custom JSON body (sent as application/JSON).
  • Entity Type (required) — Select the contact entity type: 'Company' or 'Person' (required when using structured form fields).
  • Contact Type (required) — Specify the contact type: 'Client', 'Contact', or 'Lead' (required when using structured form fields).
  • First Name (required) — Provide the contact's first name (required when using structured form fields).
  • Last Name (required) — Provide the contact's last name (required when using structured form fields).
  • Middle Name — Provide the contact's middle name (optional when using structured form fields).
  • Email — Provide the contact's email address (optional when using structured form fields).
  • Company Name or ID — Optionally specify the related company by selecting from the loaded companies list or using an expression (when using structured form fields).
  • Phone Number — Provide the contact's phone number (optional when using structured form fields).
  • Address Street — Specify the contact's street address (optional when using structured form fields).
  • Address Street Number — Specify the contact's street number (optional when using structured form fields).
  • Address Zip Code — Specify the zip code for the contact's address (optional when using structured form fields).
  • Website URL — Provide the contact's website URL (optional when using structured form fields).
  • Job Title — Specify the contact's job title (optional when using structured form fields).
  • Tax Number — Provide the contact's tax number (optional when using structured form fields).
  • Legal Identification Number — Provide the contact's legal identification number (optional when using structured form fields).
  • Description — Add a description for the contact (optional when using structured form fields).
  • Facebook — Provide the Facebook URL for the contact (optional when using structured form fields).
  • Twitter — Provide the Twitter URL for the contact (optional when using structured form fields).
  • LinkedIn — Provide the LinkedIn URL for the contact (optional when using structured form fields).
  • Inform Lead — Set whether to inform the lead (optional boolean, defaults to false when using structured form fields).
  • Lead Status — Select the lead status: Accepted, Contacted, Created Proposal, Disqualified, Negotiating, Pending Contact, Qualified, Sent, or Unassigned (optional when using structured form fields).
  • Lead Request Title — Provide a title for the lead request (optional when using structured form fields).
  • Lead Request Description — Provide a description for the lead request (optional when using structured form fields).
  • Lead Budget — Specify the budget for the lead as a number (optional when using structured form fields).
  • Lead Origin — Provide the origin of the lead (optional when using structured form fields).
  • Custom JSON Body (required) — Provide a raw JSON object to send as the request body (used only if 'Custom JSON' input method is selected).

Output shape

a single record

Returns the created contact's data as a JSON object corresponding to the response from the Aqtos API. If multiple input items are processed, returns an array of responses each paired with its input item index.

Examples

Example 1: Create a person contact as a client

Set 'Body Input Method' to 'Form Fields'; set 'Entity Type' to 'Person'; 'Contact Type' to 'Client'; specify first and last name and optionally other fields; execute to create the contact.

Example 2: Create a contact with a custom JSON body

Set 'Body Input Method' to 'Custom JSON' and provide the complete JSON object in 'Custom JSON Body'; execute to send the raw payload to create the contact.

Links

Discussion