---
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  = "appRQjxHtGqgbEPGq";
    Table = "tbl4NnuxPgicpsryE";
    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 "app3ePUtRs2xnuxhh" \
             --table "tblKRSHY9lDuF5Ltu" \
             --title "2fcb5be7-f286-4bbd-aaf4-9591f2e406b2" \
             --fielddata "{'name':'2fcb5be7-f286-4bbd-aaf4-9591f2e406b2','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 "app3ePUtRs2xnuxhh" ^
             --table "tblKRSHY9lDuF5Ltu" ^
             --title "2fcb5be7-f286-4bbd-aaf4-9591f2e406b2" ^
             --fielddata "{'name':'2fcb5be7-f286-4bbd-aaf4-9591f2e406b2','type':'number','options':{'precision':0}}"
        ```
    </TabItem>
</Tabs>


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