---
title: "Add a contact to a layout"
method: POST
path: "/matters/{matterId}/layouts/{itemId}/contacts"
tags: ["Layout Matter Items"]
---

# Add a contact to a layout

`POST /matters/{matterId}/layouts/{itemId}/contacts`

## Request

- Base URL: `https://api.smokeball.com`
- URL: `https://api.smokeball.com/matters/{matterId}/layouts/{itemId}/contacts`
- Auth: API key in header `x-api-key` and API key in header `Authorization`

Adds a new contact on a specified layout.

## Path parameters

- `matterId` string, uuid, required
- `itemId` string, uuid, required

## Request body

- LayoutContactData
  - `key` string, required: Name (mapping) of the layout field that contains ContactId.
  - `contactId` string, uuid, required: Unique identifier for the layout contact.

## Response `202`

When request is accepted

## Other responses

- `404`: When layout item with specified id does not exist on the matter.

---

[API](https://skmtc.dev/smokeball/apis/smokeball-api.md) - [All operations](https://skmtc.dev/smokeball/apis/smokeball-api/llms.txt) - [OpenAPI document](https://skmtc.dev/smokeball/apis/smokeball-api/revisions/6e350cf667d4?raw)