0

Create Single Record

by
Published Jun 6, 2022

Create one record in a table.

Script airtable Verified

The script

Submitted by hugo989 Typescript (fetch-only)
Verified 5 days ago
1
//native
2

3
export type DynSelect_base_id = string
4
export type DynSelect_table_id = string
5

6
// Dropdown of the bases the token can access.
7
export async function base_id(auth: RT.Airtable) {
8
  const options: { value: string; label: string }[] = []
9
  let offset: string | undefined = undefined
10
  do {
11
    const url = new URL("https://api.airtable.com/v0/meta/bases")
12
    if (offset) {
13
      url.searchParams.append("offset", offset)
14
    }
15
    const response = await fetch(url, {
16
      headers: {
17
        Authorization: `Bearer ${auth.apiKey}`,
18
        Accept: "application/json",
19
      },
20
    })
21
    if (!response.ok) {
22
      throw new Error(`${response.status} ${await response.text()}`)
23
    }
24
    const page = (await response.json()) as {
25
      bases: { id: string; name: string }[]
26
      offset?: string
27
    }
28
    options.push(...page.bases.map((b) => ({ value: b.id, label: b.name })))
29
    offset = page.offset
30
  } while (offset)
31
  return options
32
}
33

34
async function listTables(auth: RT.Airtable, base_id: string) {
35
  if (!base_id) {
36
    return []
37
  }
38
  const response = await fetch(
39
    `https://api.airtable.com/v0/meta/bases/${base_id}/tables`,
40
    {
41
      headers: {
42
        Authorization: `Bearer ${auth.apiKey}`,
43
        Accept: "application/json",
44
      },
45
    }
46
  )
47
  if (!response.ok) {
48
    throw new Error(`${response.status} ${await response.text()}`)
49
  }
50
  const { tables } = (await response.json()) as {
51
    tables: {
52
      id: string
53
      name: string
54
      fields: { id: string; name: string; type: string }[]
55
      views: { id: string; name: string }[]
56
    }[]
57
  }
58
  return tables
59
}
60

61
// Dropdown of the tables in the chosen base.
62
export async function table_id(auth: RT.Airtable, base_id: DynSelect_base_id) {
63
  return (await listTables(auth, base_id)).map((t) => ({
64
    value: t.id,
65
    label: t.name,
66
  }))
67
}
68

69
/**
70
 * Create Single Record
71
 * Create one record in a table. fields is keyed by field name (or field ID), e.g. { "Name": "Acme", "Stage": "Won" }; computed fields cannot be written. Enable typecast to let Airtable convert strings (select option names, dates) to the field's type.
72
 */
73
export async function main(
74
  auth: RT.Airtable,
75
  base_id: DynSelect_base_id,
76
  table_id: DynSelect_table_id,
77
  fields: { [key: string]: any },
78
  typecast: boolean | undefined,
79
  return_fields_by_field_id: boolean | undefined
80
) {
81
  const response = await fetch(
82
    `https://api.airtable.com/v0/${base_id}/${table_id}`,
83
    {
84
      method: "POST",
85
      headers: {
86
        Authorization: `Bearer ${auth.apiKey}`,
87
        "Content-Type": "application/json",
88
        Accept: "application/json",
89
      },
90
      body: JSON.stringify({
91
        fields,
92
        typecast: typecast === true,
93
        returnFieldsByFieldId: return_fields_by_field_id === true,
94
      }),
95
    }
96
  )
97
  if (!response.ok) {
98
    throw new Error(`${response.status} ${await response.text()}`)
99
  }
100

101
  return await response.json()
102
}
103

Other submissions
  • Submitted by rossmccrann Deno
    Created 1162 days ago
    1
    import { Airtable } from "https://deno.land/x/airtable/mod.ts";
    2
    
    
    3
    type Airtable = {
    4
      apiKey: string;
    5
    };
    6
    
    
    7
    type AirtableTable = {
    8
      baseId: string;
    9
      tableName: string;
    10
    };
    11
    export async function main(
    12
      at_con: Airtable,
    13
      at_table: AirtableTable,
    14
      new_record: object,
    15
    ) {
    16
      const airtable = new Airtable({ ...at_con, ...at_table });
    17
    
    
    18
      const createOne = await airtable.create(new_record);
    19
    
    
    20
      return { message: "Created record in table" };
    21
    }
    22
    
    
  • Submitted by hugo697 Deno
    Created 529 days ago
    1
    import { Airtable } from "https://deno.land/x/airtable/mod.ts";
    2
    
    
    3
    type Airtable = {
    4
      apiKey: string;
    5
    };
    6
    
    
    7
    type AirtableTable = {
    8
      baseId: string;
    9
      tableName: string;
    10
    };
    11
    export async function main(
    12
      atCon: Airtable,
    13
      atTable: AirtableTable,
    14
      newRecord: object,
    15
    ) {
    16
      const airtable = new Airtable({ ...atCon, ...atTable });
    17
    
    
    18
      const createOne = await airtable.create(newRecord);
    19
    
    
    20
      return createOne;
    21
    }