Match

# spec.yml
name: Collection Name
methods:
  match:
    fields:
      - email
      - externalId
    parametersSchema:
      type: object
      properties:
        caseSensitive:
          type: boolean
          default: true

module.exports = async ({ fields, credentials, parameters }) => {
  const queryParams = {}

  // Build query from match fields
  if (fields.email) {
    queryParams.email = fields.email
  }

  const response = await makeApiRequest({
    method: 'GET',
    path: '/api/contacts',
    query: queryParams,
    credentials,
  })

  // Return first matching record
  return {
    record: response.data.length > 0 ? response.data[0] : null,
  }
}

// Input:
{
  "fields": {
    "email": "john@example.com"
  }
}

// Returns:
{
  "record": {
    "contact_id": "123",
    "email_address": "john@example.com",
    "first_name": "John",
    "last_name": "Doe"
  }
}