Start
Guides
Concepts
API endpoints
POST
Import link map entries
https://linkshift.app/api/v1/link-map-entries/importBulk upserts entries for a link map and returns import totals plus row-level failures.
Operation ID:
importLinkMapEntriesTags: Link Map EntriesSecurity
- ApiKeyAuth: apiKey | header:X-API-Key | API key generated in LinkShift dashboard (`Organization -> Manage API keys`).
Parameters
This endpoint has no parameters.
Request body schema
requestBodyobjectrequired
Payload for bulk import/upsert of link-map entries.
entriesarray of objectrequired
Entries to create or update.
destinationstringrequired
Destination URL resolved for the key.
keystringrequired
Lookup key.
linkMapIdstringrequired
Parent link-map ID.
Response schema
Import summary
Content type:
application/jsonresponse 200objectrequired
Import summary including totals and row-level failures.
createdintegerrequired
Number of newly created entries.
failedintegerrequired
Number of rows rejected during import.
failuresarray of objectrequired
Row-level failures with index, key, and reason.
indexintegerrequired
Index of failed row in import payload.
keystringrequired
Entry key from failed row.
reasonstringrequired
Validation or processing failure reason.
totalintegerrequired
Number of processed rows.
updatedintegerrequired
Number of updated entries.