eKyte icon

eKyte

Create and retrieve data from eKyte (tasks, projects, tickets, boards, workspaces, notes, notifications)

Insertion Order → Create

AI-generated

Overview

This node operation creates a new insertion order person record in the eKyte system. It is useful for managing and adding detailed person records related to insertion orders, including personal information, classifications, and associated tags. For example, it can be used to add a new individual or legal entity with their full name, document details, birth date, and classification as customer, supplier, or media vehicle.

Use Case Examples

  1. Creating a new person record for an advertising insertion order with detailed personal and classification data.
  2. Adding a legal entity as a person record with state and municipal registration numbers.

Properties

Name Meaning
userEmail The email address of the eKyte user performing this operation.
name The full name of the person or contact.
personAlias A short name or nickname for the person.
personBornAt The date of birth of the person in ISO 8601 format.
personType The type of the person, either Individual or Legal Entity.
personDocument The document of the person.
personIdCardNumber The identity card number (RG) of the person.
personStateRegistrationOptional Whether the state registration is optional for this person.
personStateRegistration State registration number for legal entities.
personMunicipalRegistration Municipal registration number for legal entities.
personIsCustomer Whether this person is classified as a customer.
personIsSupplier Whether this person is classified as a supplier.
personIsVehicle Whether this person is classified as a media vehicle.
notes Additional notes or observations about this record.
personAvatarId The ID of the avatar image to associate with this person.
tagIds List of tag IDs to associate with the person or contact.

Output

JSON

  • json
    • UserEmail - The email of the user who performed the creation operation.
    • Name - The full name of the created person.
    • Alias - The alias or nickname of the created person.
    • BornAt - The birth date of the created person.
    • Type - The type of the created person (Individual or Legal Entity).
    • Document - The document identifier of the created person.
    • IdCardNumber - The identity card number of the created person.
    • StateRegistration - The state registration number for legal entities.
    • StateRegistrationOptional - Indicates if state registration is optional.
    • MunicipalRegistration - The municipal registration number for legal entities.
    • IsVehicle - Indicates if the person is classified as a media vehicle.
    • IsSupplier - Indicates if the person is classified as a supplier.
    • IsCustomer - Indicates if the person is classified as a customer.
    • Notes - Additional notes about the person.
    • AvatarId - The avatar image ID associated with the person.
    • Tags - Tags associated with the person.

Dependencies

  • An API key credential for eKyte API authentication

Troubleshooting

  • Ensure the userEmail parameter is correctly provided and corresponds to a valid eKyte user.
  • Verify that required fields like name and personType are not empty.
  • Check API response for detailed error messages if the creation fails, such as invalid document format or missing mandatory fields.
  • Network issues or incorrect baseUrl can cause request failures; verify connectivity and URL correctness.

Discussion