diff --git a/openapi/src/ingestion.openapi.yaml b/openapi/src/ingestion.openapi.yaml
index c4dd63fddc..f8ac5604cb 100644
--- a/openapi/src/ingestion.openapi.yaml
+++ b/openapi/src/ingestion.openapi.yaml
@@ -1192,6 +1192,7 @@ paths:
         Replace the contents of an existing Lookup Table.
         ***
         [block:api-header]
+        Lookup Tables must be [created via our UI](https://docs.mixpanel.com/docs/data-structure/lookup-tables#how-do-i-upload-a-lookup-table). Once a Lookup Table is created, its contents can be replaced via this API.
         {
           "title": "Validation"
         }
@@ -1200,13 +1201,14 @@ paths:
         * The first row of the lookup table is a header row. The values in the header must be unique, as each one uniquely identifies a column of the table. These will appear as properties of the lookup table in Mixpanel's UI.
         * The CSV must be valid according to [RFC4180](https://datatracker.ietf.org/doc/html/rfc4180).
         * If the `Content-Encoding: gzip` header is supplied, the table will be decompressed before parsing.
+        
         [block:api-header]
         {
           "title": "Types"
         }
         [/block]
         * Integers or floats will be parsed as numbers.
-        * RFC3339 timestamps (`2021-08-21T05:36:01Z`) will parsed as datetimes.
+        * [RFC3339](https://datatracker.ietf.org/doc/html/rfc3339) timestamps (`2021-08-21T05:36:01Z`) will parsed as datetimes.
         * `true` or `false` (case-insensitive) will be parsed as boolean.
         * Empty fields (two adjacent commas) will be treated as `undefined`
         * Comma separated, quoted strings in square brackets (`"["Free","Paid","Enterprise"]"`) will be parsed as list of strings.