---
updatedAt: 2026-05-28T15:48:11.000Z
agentTools:
  projectIndex: https://dev.frontapp.com/llms.txt
---

# Add contact handle

Adds a new handle to a contact.

Required scope: `contacts:write`

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "x-api-id": "front",
  "x-explorer-enabled": false,
  "x-proxy-enabled": true,
  "x-samples-enabled": true,
  "info": {
    "version": "1.0.0",
    "title": "Core API",
    "contact": {
      "name": "Front Platform",
      "url": "https://community.front.com"
    }
  },
  "security": [
    {
      "http": []
    }
  ],
  "servers": [
    {
      "url": "https://api2.frontapp.com"
    }
  ],
  "components": {
    "schemas": {
      "ContactHandle": {
        "type": "object",
        "required": [
          "handle",
          "source"
        ],
        "properties": {
          "handle": {
            "type": "string",
            "description": "Handle used to reach the contact.",
            "example": "dwight@limitlesspaper.com"
          },
          "source": {
            "type": "string",
            "enum": [
              "twitter",
              "email",
              "phone",
              "facebook",
              "intercom",
              "front_chat",
              "custom"
            ],
            "description": "Source of the handle. Can be `email`, `phone`, `twitter`, `facebook`, `intercom`, `front_chat`, or `custom`.",
            "example": "email"
          }
        }
      }
    },
    "securitySchemes": {
      "http": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "JWT"
      }
    }
  },
  "paths": {
    "/contacts/{contact_id}/handles": {
      "post": {
        "summary": "Add contact handle",
        "operationId": "add-contact-handle",
        "description": "Adds a new handle to a contact.\n\nRequired scope: `contacts:write`",
        "tags": [
          "Contact Handles"
        ],
        "parameters": [
          {
            "in": "path",
            "name": "contact_id",
            "required": true,
            "description": "The contact ID. Alternatively, you can supply the contact's source and handle as a [resource alias](https://dev.frontapp.com/docs/resource-aliases-1).",
            "schema": {
              "type": "string",
              "default": "crd_123"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ContactHandle"
              }
            }
          }
        },
        "responses": {
          "204": {
            "description": "No content"
          }
        },
        "x-required-scopes": [
          "contacts:write"
        ]
      }
    }
  }
}
```