> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Formilla

> Create or update customer contacts through Formilla's Secure Token REST API for live chat and marketing automation workflows.

![Formilla logo](https://mintcdn.com/composio-preview/GL28i3tBlbEbBd-f/images/toolkits/formilla.svg?fit=max\&auto=format\&n=GL28i3tBlbEbBd-f\&q=85\&s=8451bbf5639eef77ccf40c49b6d2e2b4)

* **Category:** customer support
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 1
* **Triggers:** 0
* **Slug:** `FORMILLA`
* **Version:** 20261030\_00

## Tools

> [accordion] Upsert Contact
>
> **Slug:** `FORMILLA_UPSERT_CONTACT`
>
> Create a Formilla contact or overwrite supplied fields on an existing contact matched by user ID first, then email. Returns no contact data, ID, or create-versus-update result.
>
> #### Input Parameters
>
> **email** `string`
>
> Contact email address. Required only when user\_id is omitted; it is the fallback match key when both identities are supplied.
>
> **phone** `string`
>
> Contact phone number. If the matched contact already exists, supplying this overwrites its stored phone number.
>
> **user\_id** `string`
>
> Stable unique contact identifier, at most 50 characters. Provide this or email; when both are supplied, Formilla matches user\_id first.
>
> **last\_name** `string`
>
> Contact last name. If the matched contact already exists, supplying this overwrites its stored last name.
>
> **first\_name** `string`
>
> Contact first name. If the matched contact already exists, supplying this overwrites its stored first name.
>
> **signed\_up\_at** `integer`
>
> Contact signup time as a Unix timestamp in seconds. If supplied for an existing contact, it overwrites the stored signup time.
>
> **is\_unsubscribed** `boolean`
>
> Whether the contact is unsubscribed from email. Omit to avoid changing this field; supplying it overwrites the stored value on a match.
>
> **custom\_attributes** `object`
>
> Custom contact fields to write. Attribute names may be at most 150 characters and cannot contain . \$ \~ \` ! @ # % ^ & \* \{ } | \ ' or curly quotes. Use an \_date suffix with a Unix timestamp for date attributes; Formilla documents null only for an existing attribute. Supplied attributes may overwrite stored values.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
