# `DocuSign.Api.CustomTabs`
[🔗](https://github.com/neilberkman/docusign_elixir/blob/v3.4.0/lib/docusign/api/custom_tabs.ex#L5)

API calls for all endpoints tagged `CustomTabs`.

# `tab_delete_custom_tab`

```elixir
@spec tab_delete_custom_tab(
  DocuSign.Connection.t(),
  String.t(),
  String.t(),
  keyword()
) ::
  {:ok, nil} | {:error, Req.Response.t()}
```

Deletes custom tab information.
Deletes the custom from the specified account.

### Parameters

- `connection` (DocuSign.Connection): Connection to server
- `account_id` (String.t): The external account number (int) or account ID GUID.
- `custom_tab_id` (String.t): The Docusign-generated custom tab ID for the custom tab to be applied. This can only be used when adding new tabs for a recipient. When used, the new tab inherits all the custom tab properties.
- `opts` (keyword): Optional parameters

### Returns

- `{:ok, nil}` on success
- `{:error, Req.Response.t}` on failure

# `tab_get_custom_tab`

```elixir
@spec tab_get_custom_tab(DocuSign.Connection.t(), String.t(), String.t(), keyword()) ::
  {:ok, DocuSign.Model.TabMetadata.t()} | {:error, Req.Response.t()}
```

Gets custom tab information.
Retrieves information about the requested custom tab on the specified account.

### Parameters

- `connection` (DocuSign.Connection): Connection to server
- `account_id` (String.t): The external account number (int) or account ID GUID.
- `custom_tab_id` (String.t): The Docusign-generated custom tab ID for the custom tab to be applied. This can only be used when adding new tabs for a recipient. When used, the new tab inherits all the custom tab properties.
- `opts` (keyword): Optional parameters

### Returns

- `{:ok, DocuSign.Model.TabMetadata.t}` on success
- `{:error, Req.Response.t}` on failure

# `tab_put_custom_tab`

```elixir
@spec tab_put_custom_tab(DocuSign.Connection.t(), String.t(), String.t(), keyword()) ::
  {:ok, DocuSign.Model.TabMetadata.t()} | {:error, Req.Response.t()}
```

Updates custom tab information.  
Updates the information in a custom tab for the specified account.

### Parameters

- `connection` (DocuSign.Connection): Connection to server
- `account_id` (String.t): The external account number (int) or account ID GUID.
- `custom_tab_id` (String.t): The Docusign-generated custom tab ID for the custom tab to be applied. This can only be used when adding new tabs for a recipient. When used, the new tab inherits all the custom tab properties.
- `opts` (keyword): Optional parameters
  - `:body` (TabMetadata): 

### Returns

- `{:ok, DocuSign.Model.TabMetadata.t}` on success
- `{:error, Req.Response.t}` on failure

# `tabs_get_tab_definitions`

```elixir
@spec tabs_get_tab_definitions(DocuSign.Connection.t(), String.t(), keyword()) ::
  {:ok, DocuSign.Model.TabMetadataList.t()} | {:error, Req.Response.t()}
```

Gets a list of all account tabs.
Retrieves a list of all tabs associated with the account.

### Parameters

- `connection` (DocuSign.Connection): Connection to server
- `account_id` (String.t): The external account number (int) or account ID GUID.
- `opts` (keyword): Optional parameters
  - `:custom_tab_only` (String.t): When **true,** only custom tabs are returned in the response. 

### Returns

- `{:ok, DocuSign.Model.TabMetadataList.t}` on success
- `{:error, Req.Response.t}` on failure

# `tabs_post_tab_definitions`

```elixir
@spec tabs_post_tab_definitions(DocuSign.Connection.t(), String.t(), keyword()) ::
  {:ok, DocuSign.Model.TabMetadata.t()} | {:error, Req.Response.t()}
```

Creates a custom tab.
Creates a tab with pre-defined properties, such as a text tab with a certain font type and validation pattern. Users can access the custom tabs when sending documents through the Docusign web application.  Custom tabs can be created for approve, checkbox, company, date, date signed, decline, email, email address, envelope ID, first name, formula, full name, initial here, last name, list, note, number, radio, sign here, signer attachment, SSN, text, title, and zip tabs.

### Parameters

- `connection` (DocuSign.Connection): Connection to server
- `account_id` (String.t): The external account number (int) or account ID GUID.
- `opts` (keyword): Optional parameters
  - `:body` (TabMetadata): 

### Returns

- `{:ok, DocuSign.Model.TabMetadata.t}` on success
- `{:error, Req.Response.t}` on failure

---

*Consult [api-reference.md](api-reference.md) for complete listing*