Home / Docs / Bulk CSV

Bulk CSV

Core+. Import up to 5000 rows to create or update links. Country redirect_rules need 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: [{"countries":["US","CA"],"url":"https://example.com/na"}] — see product docs for country redirect rules.

Result file

Returned CSV adds ok, short_url, message per row.

OpenAPI: see API · POST /links/import.