# Add Phone

The Add Phones operation allows you to insert one or more phone numbers into an already existing person record.

This action is especially useful to enrich a contact's profile over time. If a lead who initially provided only an email later provides their phone in an interaction, you can use this operation to complement the record without overwriting other data.

The operation adds the new phones to the person's contact list, keeping the ones that already existed.

#### How to Configure

1. In Hablla Studio, add the "People" block to your automation flow.
2. In the "Operation" field, select the "Add Phones" option.
3. In the "Person ID" field (`personId`), enter the unique identifier of the person to whom you want to add the phones.
4. In the "Phones" section, fill in the details of the phone number(s) you want to add.

***

### Parameters (Using Fields)

| Field     | Type              | Required? | Description                                                                                                                                                            |
| --------- | ----------------- | --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Person ID | Text              | ✅ Yes     | The unique ID of the person who will receive the new phone numbers.                                                                                                    |
| Phones    | Fields Collection | ✅ Yes     | A list containing one or more phones to be added. Each item in the list must include: `Type` (Personal or Business), `Phone` (the number) and `Is WhatsApp?` (yes/no). |

Export to Spreadsheets

***

### Structure (Using JSON)

The JSON request body must be an array called `phones`, containing one or more phone objects.

JSON

```
{
  "phones": [
    {
      "type": "business",
      "phone": "+5511987654321",
      "is_whatsapp": true
    },
    {
      "type": "personal",
      "phone": "+5511912345678",
      "is_whatsapp": false
    }
  ]
}
```

***

### 🚀 Example Use Case

Goal: When a customer responds to a satisfaction survey and provides their WhatsApp number for contact, add that number to their record in Hablla.

1. Create a flow that starts with a Webhook trigger, receiving the completed survey data (including the email and the new phone).
2. Use the "Find Person by Email" operation to find the `personId` of the customer based on the received email.
3. Add the "People" block with the "Add Phones" operation.
4. In the "Person ID" field, enter the ID variable found in the previous step (`{{steps.2.result.id}}`).
5. In the "Phones" section, map the phone data received in the trigger:
   * Type: Set to `personal`.
   * Phone: Map the phone variable coming from the webhook.
   * Is WhatsApp?: Set to `true`.

This way, your customers' profiles are automatically enriched with new contact information, centralizing communication and ensuring that the data is always up to date.