AvantGuard - Pax8 - Partner icon

AvantGuard - Pax8 - Partner

AvantGuard - Pax8

Overview

This node operation creates a new contact within a specified company in the Pax8 Partner system. It is useful for automating the addition of contacts to a company's profile, such as adding new employees, clients, or partners into the CRM or contact management system integrated with Pax8.

Typical use cases include:

  • Automatically adding new customer contacts when onboarding.
  • Syncing contacts from other systems into Pax8.
  • Managing contact lists programmatically without manual entry.

For example, you could use this node to add a new sales lead's contact information directly into the company's contact list after capturing it from a web form.

Properties

Name Meaning
Company Id The unique identifier of the company where the contact will be created.
First Name The first name of the contact.
Last Name The last name of the contact.
Email The email address of the contact.
Phone The phone number of the contact.
Additional Body Fields Optional additional fields to include in the contact creation request:
- Id An optional unique identifier for the contact.
- Created Date The date the contact was created (format: YYYY-MM-DD).
- Types A JSON array describing types or categories associated with the contact.

Output

The node outputs JSON data representing the newly created contact as returned by the Pax8 API. This typically includes all the contact details submitted plus any additional metadata assigned by the system, such as creation timestamps or system-generated IDs.

If the node supports binary data output, it would represent attachments or files related to the contact, but based on the provided code and properties, this node focuses on JSON contact data only.

Dependencies

  • Requires an active connection to the Pax8 Partner API.
  • Needs an API authentication token configured in n8n credentials to authorize requests.
  • The base URL for API requests is https://api.pax8.com/v1.
  • The node sends JSON-formatted HTTP requests and expects JSON responses.

Troubleshooting

  • Missing Required Fields: Ensure all required fields (Company Id, First Name, Last Name, Email, Phone) are provided; otherwise, the API will reject the request.
  • Invalid Company Id: Using an incorrect or non-existent company ID will cause the API to return an error indicating the company was not found.
  • Authentication Errors: If the API key or token is invalid or expired, the node will fail with an authentication error. Verify and update credentials in n8n.
  • Malformed JSON in Types Field: The "Types" field expects valid JSON. Invalid JSON syntax will cause parsing errors before sending the request.
  • API Rate Limits: Frequent calls may hit rate limits imposed by the Pax8 API, resulting in temporary failures.

Links and References

Discussion