Create

# spec.yml
name: Collection Name
methods:
  create:
    fields:
      - email
      - firstName
      - lastName
    requiredFields:
      - email
    excludedFields:
      - id
    parametersSchema:
      type: object
      properties:
        sendWelcomeEmail:
          type: boolean
          default: true

path: /contacts
method: POST
requestMapping:
  data:
    email: { $var: $.fields.email }
    first_name: { $var: $.fields.firstName }
    last_name: { $var: $.fields.lastName }
    phone: { $var: $.fields.phone }
    send_welcome_email: { $var: $.parameters.sendWelcomeEmail }
responseMapping:
  id: { $string: { $var: response.data.contact_id } }

implementationType: operation-mapping
mapping:
  operationKey: createContact
  inputMapping:
    contactData: { $var: $.fields }
    options:
      sendWelcomeEmail: { $var: $.parameters.sendWelcomeEmail }
  outputMapping:
    id: { $string: { $var: result.contactId } }

export default async function create({ apiClient, fields, parameters }) {
  const requestBody = {
    email: fields.email,
    first_name: fields.firstName,
    last_name: fields.lastName,
    phone: fields.phone,
    send_welcome_email: parameters?.sendWelcomeEmail || false,
  }

  const response = await apiClient.post('/contacts', requestBody)

  return {
    id: String(response.data.contact_id),
  }
}