Create Drop

Create your drop with customizable settings.

The Create Drop API allows you to generate and share text drops with customizable settings, including visibility options, expiration dates, and custom URLs. You can also secure your drops with a password and link them to your account.
Arguments
title
string
Optional
Max Characters: 80

Title of your drop. If no title is provided it will default to No Title.

content
string
Required
Max Characters: 5000

Main content of your drop. Markdown is supported.

visibility
string
Required

Visibility for your drop. You can choose from the following options.

public : Anyone can view your drop.

unlisted: Only people with the dropId can view.

private: Only accessible with secure password.

customUrl
string
Optional
Max Characters: 8

Custom URL for your drop. Only unique URLs are valid.

expireAt
string
Required

Expiration date for your drop. Only valid expireAt are supported.

15-minutes

1-hour

12-hours

1-day

3-days

1-week

password
string
Optional
Max Characters: 6

Password for your private drop. Only works if the visibility is set to private. Required in case of private drop.

linkMyId
boolean
Optional

Link your account which owns the apiKey to your drop. Anonymous drop will be created if no value is provided

Sample Request
const url = "https://droplink.cc/api/v1/drop/create";
const dropData = {
  title: "My First Drop",
  content: "This is the main content of the drop. **Markdown** _supported_!",
  visibility: "private",
  customUrl: "my-first-drop",
  expireAt: "15-minutes",
  password: "123456",
  linkMyId: true
};
try {
  const response = await fetch(url, {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "x-api-key": "YOUR_API_KEY"
    },
    body: JSON.stringify(dropData)
  });
  if (!response.ok) {
    throw new Error(`HTTP error! Status: ${response.status}`);
  }
  const responseData = await response.json();
  console.log("Drop created successfully:", responseData);
} catch (error) {
  console.error("Error creating drop:", error);
}
Sample Response
200
{
  "dropId": "8556f9b5-6dc8-4f80-981c-52e8d8aad61c"
}
IntroductionView Drop