Home / Docs / Bulk CSV

Bulk CSV

Bulk CSV import for lit.onl links (Core+): create or update up to 5,000 rows per file. Country redirect_rules and advanced columns require Growth+.

Dashboard Import CSV is Core+. Public POST /v1/links/import and MCP import_csv need Growth+ (API/MCP gate). Max 5000 rows per file.

Columns

Header row required. url is required on create.

ColumnCreateUpdate
urlRequiredOptional
slugOptional (Core+ rules)Match existing if no id
expires_atRFC 3339 or empty for neverOptional
UTM fieldsOptionalOptional
passwordOptional (Core+)Empty clears
confirm_leavetrue / falseOptional
redirect_rulesJSON array (Growth+)Optional; omit to keep
idOmitSet to patch that link

Example redirect_rules: {"v":1,"rules":[{"when":{"field":"country","op":"in","value":["US","CA"]},"url":"https://example.com/na"}]} — see RediRL for text rules, or the Rules Flow editor in the dashboard.

Result file

Returned CSV adds ok, short_url, message per row.

OpenAPI: see API · POST /links/import.