﻿---
sidebar_position: 3
---

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

# Create base
 Creates a new database



`Function CreateDatabase(Val Token, Val Workspace, Val Name, Val TableCollection) Export`

  | Parameter | CLI option | Type | Description |
  |-|-|-|-|
  | Token | --token | String | Token |
  | Workspace | --ws | String | Workspace identifier |
  | Name | --title | String | New base name |
  | TableCollection | --tablesdata | Map Of KeyAndValue | Table description: Key > name, Value > array of fields |

  
  Returns:  Map Of KeyAndValue - serialized JSON response from Airtable

<br/>




```bsl title="Code example"
    Token  = "patNn4BXW66Yx3pdj.5b93c53cab554a8387de02d...";
    Region = "wspdf8yl1yZz3PmWZ";
    Name   = "TestDatabase";

    FieldArray = New Array;
    FieldArray.Add(OPI_Airtable.GetNumberField("Number"));
    FieldArray.Add(OPI_Airtable.GetStringField("String"));

    TableName = "TestTable";

    TableMapping = New Map;
    TableMapping.Insert(TableName, FieldArray);

    Result = OPI_Airtable.CreateDatabase(Token, Region, Name, TableMapping);
```
 



```json title="Result"
{
 "id": "appD2vawGftoNUTKW",
 "tables": [
  {
   "id": "tblbhqzh3PL3cS6Ch",
   "name": "TestTable",
   "primaryFieldId": "fld9JrMjoVLwSPy3C",
   "fields": [
    {
     "type": "number",
     "options": {
      "precision": 0
     },
     "id": "fld9JrMjoVLwSPy3C",
     "name": "Number"
    },
    {
     "type": "richText",
     "id": "fld044xLas7uBdddr",
     "name": "String"
    }
   ],
   "views": [
    {
     "id": "viwfJdwEI0dtqJMl6",
     "name": "Grid view",
     "type": "grid"
    }
   ]
  }
 ]
}
```
