> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blinkops.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Client List

Create a new client list to group and filter web traffic based on client characteristics such as IP addresses, geographic locations, or other identifiers.

<Note>
  External Documentation

  To learn more, visit the [Akamai Client List documentation](https://techdocs.akamai.com/client-lists/reference/post-create-list).
</Note>

## Basic Parameters

<div className="integrations-table">
  | Parameter   | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
  | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | Contract ID | The ID of the contract under which the client list will be created.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
  | Group ID    | The ID of the group in which the client list should be created.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
  | Items       | A list of entries to include in the client list. Each entry requires a value, description, optional tags, and expiration date.<br /><br />The value property depends on the list type:<br />- **IP lists**: Valid IP addresses (e.g., "10.10.10.1").<br />- **GEO lists**: Country codes (e.g., "US").<br />- **ASN lists**: Autonomous System Numbers (e.g., "21928").<br />- **TLS\_FINGERPRINT lists**: TLS fingerprint hashes.<br />- **FILE\_HASH lists**: File hash values.<br />- **USER lists**: User identifiers.<br /><br />**Format:**<br /><pre><code>\[<br />  \{<br />    "value": "value",<br />    "description": "description",<br />    "tags": \["tag"],<br />    "expirationDate": "2025-12-31T23:59:59.700+00:00"<br />  }<br />]</code></pre> |
  | Name        | The name of the client list.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
  | Notes       | A descriptive text explaining the purpose and intended use of the client list.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
  | Tags        | A comma-separated list of labels to categorize the client list.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
  | Type        | The data type that the client list will contain.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
</div>

## Advanced Parameters

<div className="integrations-table">
  | Parameter          | Description                                                                      |
  | ------------------ | -------------------------------------------------------------------------------- |
  | Account Switch Key | An account switch key to execute the operation on behalf of a different account. |
</div>

## Example Output

```json theme={"dark"}
{
	"contractId": "C-0N7RAC71",
	"createDate": "2023-04-05T18:20:42.090+00:00",
	"createdBy": "adevi",
	"deprecated": false,
	"groupId": 12345,
	"groupName": "Acme IT Group",
	"items": [
		{
			"createDate": "2023-04-05T18:20:42.892+00:00",
			"createdBy": "jsmith",
			"description": "Canada - North America",
			"expirationDate": "2023-12-31T23:59:19.700+00:00",
			"productionStatus": "INACTIVE",
			"stagingStatus": "INACTIVE",
			"tags": [
				"itemRed",
				"itemGreen"
			],
			"type": "GEO",
			"updateDate": "2023-04-05T18:20:42.892+00:00",
			"updatedBy": "jdupont",
			"value": "CA"
		}
	],
	"itemsCount": 2,
	"listId": "12345_NORTHAMERICAGEOALLOWLIST",
	"listType": "CL",
	"name": "NorthAmericaGeoAllowlist",
	"notes": "GEO code allowlist",
	"productionActivationStatus": "INACTIVE",
	"productionActiveVersion": 0,
	"readOnly": false,
	"shared": false,
	"stagingActivationStatus": "INACTIVE",
	"stagingActiveVersion": 0,
	"tags": [],
	"type": "GEO",
	"updateDate": "2023-04-05T18:20:42.090+00:00",
	"updatedBy": "adevi",
	"version": 1
}
```

## Workflow Library Example

[Create Client List with Akamai Client List and Send Results Via Email](https://library.blinkops.com/workflows/create-client-list-with-akamai-client-list-and-send-results-via-email)

<div className="iframe-wrapper">
  <div className="iframe-media">
    <img src="https://mintcdn.com/blinkops-2/ojHYuDeYX5FWuN8a/img/Icons/play-box.svg?fit=max&auto=format&n=ojHYuDeYX5FWuN8a&q=85&s=b8af968e71438a9499c3223c9bd29fb2" alt="Workflow Library" width="16" height="16" data-path="img/Icons/play-box.svg" />

    Preview this Workflow on desktop
  </div>

  <iframe className="iframe" src="https://library.blinkops.com/workflows/create-client-list-with-akamai-client-list-and-send-results-via-email/canvas" />
</div>