Magnet Customer icon

Magnet Customer

Consume Magnet Customer API

Actions68

Overview

This node integrates with the Magnet Customer API to manage organizations within a CRM-like system. Specifically, the Organization - Create operation allows users to create new organization records by providing detailed contact and address information.

Common scenarios for this node include:

  • Automating the creation of new organization entries when leads or deals are generated in other systems.
  • Synchronizing external databases or forms with the Magnet Customer platform.
  • Enriching CRM data by programmatically adding organizations with custom fields and multiple phone numbers.

Practical example:

  • When a new client signs up on a website, this node can automatically create an organization record in Magnet Customer with their full name, email, phones, address, and any custom metadata.

Properties

Name Meaning
Authentication Method used to authenticate API requests. Options: API Token, OAuth2.
Fullname The full name of the organization/contact. Required for creating or updating an organization.
E-Mail Email address of the organization/contact.
Phones Collection of phone numbers associated with the organization. Allows adding multiple phone entries with their number values.
Birthdate The birthdate of the contact (if applicable).
Document (CPF/CNPJ) Identification document number of the contact (e.g., CPF or CNPJ in Brazil).
State State where the organization/contact is located.
City City where the organization/contact is located.
Address Street address of the organization/contact.
Address Number Number component of the street address.
Complement Address Additional address details such as apartment, suite, etc.
Neighborhood Neighborhood or district of the address.
CEP Postal code (ZIP code) of the address.
Owners Owners associated with the organization/contact.
Custom Fields Allows setting additional custom fields not predefined in the standard schema. Users can specify field names or IDs and their corresponding values.
Life Cycle Hidden property indicating the life cycle stage of the contact (e.g., customer, lead, prospect). This is preset internally and not user-editable.
Source Hidden property indicating the source of the contact, defaulted to "n8n". Used internally to track origin.

Output

The node outputs JSON data representing the newly created organization object as returned by the Magnet Customer API. This typically includes all the properties set during creation along with any additional metadata assigned by the API (such as unique IDs).

If the API supports binary data output (not indicated here), it would be summarized accordingly, but this node primarily handles JSON data.

Dependencies

  • Requires access to the Magnet Customer API.
  • Requires either an API token or OAuth2 credentials configured in n8n for authentication.
  • The node depends on internal helper functions to make HTTP requests to the Magnet Customer endpoints.
  • No additional external services beyond Magnet Customer API are required.

Troubleshooting

  • Authentication errors: Ensure that the API token or OAuth2 credentials are correctly configured and have sufficient permissions to create organizations.
  • Validation errors: Missing required fields like "Fullname" will cause the API to reject the request. Make sure all mandatory fields are provided.
  • Custom fields issues: If custom fields are specified incorrectly (wrong IDs or unsupported types), the API may return errors. Use the node's load options to select valid custom fields.
  • Network or API downtime: Temporary connectivity issues or Magnet Customer API outages will cause request failures. Retry after some time or check API status.
  • Duplicate entries: Creating organizations with identical key identifiers might be rejected or cause duplicates depending on API rules.

Links and References

This summary is based solely on static analysis of the provided source code and property definitions without runtime execution.

Discussion