action callfire_add_contact_list_items {
  label: "Add contacts to a contact list"
  description: "Adds contacts to a contact list. Available contact sources are: list of the contact entities, list of ids of existing contacts in user's account, list of phone numbers in E.164 format (11-digits)"
  provider: callfire
  method: POST
  path: "/contacts/lists/{id}/items"
  encoding: json
  input: {
    type: "object"
    properties: {
      contactIds: {
        type: "array"
        description: "A list of ids of existing contacts in CallFire system"
        items: {
          type: "integer"
          format: "int64"
        }
      }
      contactNumbers: {
        type: "array"
        description: "A phone number in E.164 format (11-digit). Examples: 12132000384"
        items: {
          type: "string"
        }
      }
      contactNumbersField: {
        type: "string"
        description: "A type of phone number (homePhone, workPhone, mobilePhone). This parameter works together with contactNumbers and specifies which types of numbers are included to a list"
      }
      contacts: {
        type: "array"
        description: "A list of new contact objects which need to be added"
        items: {
          type: "object"
          description: "Represents a contact in CallFire platform. Contains info about the people you want to contact. It allows you to store a user-defined properties for each contact"
          properties: {
            deleted: {
              type: "boolean"
              description: "A deleted contact, deleted contacts are hidden from search results"
            }
            externalId: {
              type: "string"
              description: "An external id of a contact for syncing with external sources"
            }
            externalSystem: {
              type: "string"
              description: "External system that external id refers to"
            }
            extraPhone1: {
              type: "string"
              description: "Phone number in E.164 format (11-digit). Example: 12132000384"
            }
            extraPhone2: {
              type: "string"
              description: "Phone number in E.164 format (11-digit). Example: 12132000384"
            }
            extraPhone3: {
              type: "string"
              description: "Phone number in E.164 format (11-digit). Example: 12132000384"
            }
            firstName: {
              type: "string"
              description: "A first name of a contact"
            }
            homePhone: {
              type: "string"
              description: "Phone number in E.164 format (11-digit). Example: 12132000384"
            }
            id: {
              type: "integer"
              format: "int64"
              description: "An id of a contact"
            }
            lastName: {
              type: "string"
              description: "A last name of a contact"
            }
            mobilePhone: {
              type: "string"
              description: "Phone number in E.164 format (11-digit). Example: 12132000384"
            }
            properties: {
              type: "object"
              description: "Map of user-defined string properties for contact"
            }
            workPhone: {
              type: "string"
              description: "Phone number in E.164 format (11-digit). Example: 12132000384"
            }
            zipcode: {
              type: "string"
              description: "A Zip code of a contact"
            }
          }
        }
      }
      id: {
        type: "integer"
        format: "int64"
      }
      useCustomFields: {
        type: "boolean"
        description: "A flag to indicate how to define property names for contacts. If true, uses the field and property names exactly as defined. If false will assign custom properties and fields to A, B, C, etc"
      }
    }
    required: ["id"]
    additionalProperties: false
  }
  output: {
    type: "object"
    additionalProperties: true
  }
}