Add a contact
create_contactIdempotent
Adds a contact: a person or business the organisation deals with, such as a new supplier before adding their bill, a tenant before their tenancy, or a property owner before their property. Give a business's name, or a person's first_name and last_name. Check with list_contacts first that they are not already there: a contact already there with the same name is answered instead, and one without the type asked for is refused: add the type to that contact with update_contact instead. Only for an organisation where this connection may add and change records (list_organisations says which). The answer is the saved contact with its organisation's name.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | A business's name. Leave it out for a person and give first_name and last_name. | |
| No | Email address. | ||
| phone | No | Phone number. | |
| mobile | No | Mobile phone number. | |
| website | No | Website address. | |
| last_name | No | A person's last name. | |
| first_name | No | A person's first name. | |
| contact_types | Yes | What the contact is to the organisation, one or more of: supplier, tenant, contractor, property-owner, landlord or accountant, or a type the organisation added itself (list_choices gives every one with its label). | |
| allow_duplicate | No | Adding is safe to repeat: the same details sent again return the record already made. Set true only when the person confirms they really want a second, identical record. For a contact: set true only for a different person or business with the same name. | |
| organisation_id | No | The id of the organisation to use, from list_organisations. Leave it out when the connection covers only one organisation; it is required when it covers more than one. | |
| postal_address_line | No | Postal address, on one line, when it differs from the street address. A contractor or accountant needs a street or postal address. | |
| physical_address_line | No | Street address, on one line. |