---
sidebar_position: 1
---

import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';

# Create field
 Creates a new field in the table



`Function CreateField(Val Token, Val Base, Val Table, Val FieldStructure) Export`

  | Parameter | CLI option | Type | Required | Description |
  |-|-|-|-|-|
  | Token | --token | String | ✔ | Token |
  | Base | --base | String | ✔ | Base identifier |
  | Table | --table | String | ✔ | Table identifier |
  | FieldStructure | --fielddata | Structure Of KeyAndValue | ✔ | Description of the new field |

  
  Returns:  Map Of KeyAndValue - serialized JSON response from Airtable

<br/>




```bsl title="1C:Enterprise/OneScript code example"
    Token = "patNn4BXW66Yx3pdj.5b93c53cab554a8387de02d...";
    Base  = "appPvIb7wxCkgyZKC";
    Table = "tbl2x83eNbGHdzxxj";
    Name  = String(New UUID);

    Field  = OPI_Airtable.GetNumberField(Name);
    Result = OPI_Airtable.CreateField(Token, Base, Table, Field);
```
 

 <Tabs>
  
    <TabItem value="bash" label="Bash" default>
        ```bash
            # JSON data can also be passed as a path to a .json file
            
            oint airtable CreateField \
             --token "***" \
             --base "appffoaW7rjLmVJzQ" \
             --table "tbl53bnitoPLqT5fW" \
             --title "fcc796f1-4835-4f28-b0c5-23f26b2c8450" \
             --fielddata "{'name':'fcc796f1-4835-4f28-b0c5-23f26b2c8450','type':'number','options':{'precision':0}}"
        ```
    </TabItem>
  
    <TabItem value="bat" label="CMD/Bat" default>
        ```batch
            :: JSON data can also be passed as a path to a .json file
            
            oint airtable CreateField ^
             --token "***" ^
             --base "appffoaW7rjLmVJzQ" ^
             --table "tbl53bnitoPLqT5fW" ^
             --title "fcc796f1-4835-4f28-b0c5-23f26b2c8450" ^
             --fielddata "{'name':'fcc796f1-4835-4f28-b0c5-23f26b2c8450','type':'number','options':{'precision':0}}"
        ```
    </TabItem>
</Tabs>


```json title="Result"
{
 "type": "number",
 "options": {
  "precision": 0
 },
 "id": "fldDqI1OXajeQw5Gg",
 "name": "b3fd1280-83b2-4145-838d-3437b14adee3"
}
```