Actions28
- Companies Actions
- Products Actions
- Orders Actions
- Subscriptions Actions
- Contacts Actions
- Invoices Actions
- Usage Summaries Actions
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. |
| 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
- Pax8 API Documentation (general reference for API endpoints and authentication)
- n8n Documentation for configuring credentials and using HTTP Request nodes if needed for customizations