Omniwallet - Create Customer Tool icon

Omniwallet - Create Customer Tool

Create a customer in Omniwallet API Tool

Overview

This node, named "Omniwallet - Create Customer Tool," is designed to create a new customer record in the Omniwallet API. It is useful for automating customer management workflows where you need to add customer details such as email, name, contact information, and loyalty data into the Omniwallet system. Practical examples include onboarding new customers from an e-commerce platform, syncing CRM contacts, or managing loyalty program participants by automatically creating their profiles in Omniwallet.

Properties

Name Meaning
Email Customer's email address (required when creating a customer).
Name Customer's first name (required).
Last Name Customer's last name (optional).
Phone Customer's phone number (optional).
Level Customer's level or tier (optional).
Points Loyalty points assigned to the customer (optional, defaults to 0).
Card Customer's card number; if left empty, the system generates one automatically (optional).

Output

The node outputs JSON data representing the created customer object returned by the Omniwallet API. The output structure includes the data field containing the customer's attributes such as email, name, last name, phone, level, points, and card number. If the creation fails and the node is set to continue on failure, the output will contain an error message instead.

No binary data output is produced by this node.

Example output JSON snippet:

{
  "data": {
    "type": "customers",
    "attributes": {
      "email": "customer@example.com",
      "name": "John",
      "last_name": "Doe",
      "phone": "1234567890",
      "level": "Gold",
      "points": 100,
      "card": "1234-5678-9012"
    }
  }
}

Dependencies

  • Requires an active connection to the Omniwallet API via an API key credential.
  • The node depends on the omniwalletApiRequest function to perform authenticated HTTP POST requests to the /customers endpoint of the Omniwallet API.
  • Proper configuration of the API authentication credentials within n8n is necessary for successful operation.

Troubleshooting

  • Common issues:
    • Missing required fields like Email or Name will cause the API request to fail.
    • Invalid or expired API credentials will result in authentication errors.
    • Network connectivity problems can prevent communication with the Omniwallet API.
  • Error messages:
    • Errors returned from the API are captured and included in the output if "Continue On Fail" is enabled.
    • Typical error messages may relate to validation failures (e.g., invalid email format) or authorization issues.
  • Resolutions:
    • Ensure all required fields are provided and correctly formatted.
    • Verify that the API key credential is valid and has appropriate permissions.
    • Check network settings and firewall rules to allow outbound requests to the Omniwallet API.

Links and References

  • Omniwallet API documentation (refer to the official Omniwallet developer portal for detailed API specs).
  • n8n documentation on creating custom nodes and handling API credentials.

Discussion