POST
/
bulk-urls
/
create
Create Bulk URLs
curl --request POST \
  --url https://jmpy.me/api/v1/bulk-urls/create \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "csv_content": "<string>",
  "validated_urls": [
    {}
  ],
  "qrCode": true,
  "qrFormat": "<string>"
}
'
{
  "success": true,
  "data": {
    "results": {},
    "created": [
      {}
    ],
    "failed": [
      {}
    ]
  },
  "message": "<string>"
}
Process a batch of URLs to create short links. This endpoint accepts either a CSV file (similar to the validate endpoint) or a list of pre-validated URL objects.

​
Request

​
Headers

​
Content-Type
string
required
multipart/form-data (for file upload) or application/json (for json body)

​
Body Parameters

You must provide one of the following: file, csv_content, or validated_urls.
​
file
file
The CSV file to upload.Max Size: 5MB Format: CSV
​
csv_content
string
The raw CSV content as a string.
​
validated_urls
array
An array of URL objects that have passed validation. This is useful if you have already run the /validate endpoint and want to confirm the creation of those specific entries.Item Structure:
  • original_url: string
  • custom_alias: string (optional)
  • name: string (optional)
  • domain: string (optional)
  • tags: array of strings (optional)
​
qrCode
boolean
default:false
Whether to generate trackable QR codes for all created URLs.
​
qrFormat
string
default:"image"
The format of the returned QR codes: image (base64 PNG) or json (metadata).

​
Response

​
success
boolean
Indicates if the batch processing started successfully.
​
data
object
​
message
string
Summary of the operation (e.g., “Successfully created 50 URLs. 2 failed.”).

​
Request Examples

curl -X POST "https://jmpy.me/api/v1/bulk-urls/create" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@/path/to/urls.csv"