Create Link Group

API for creating a link group.
A link group allows you to organize and manage multiple short links under a single group.

When the number of links grows, managing settings for each link individually can become inefficient.
By grouping links together, you can apply settings such as expiration dates, click limits, passwords, notifications, and analytics at the group level.

Options configured for a group are applied to all links within that group. If both link-level and group-level settings exist, the group settings take precedence.

You can also organize links by campaign, project, or marketing channel, making it easier to analyze performance and manage links at the group level.

The generated group ID can be used with the Link Creation API.

POST

/api/link-group/v1/create

{
    "nm": "Youtube Group",
    "memo": "A group of links included in the description section of a YouTube video.",
    "nonmemberSticsPwd": "123456"
}

Request Parameters

nm string required
Group name.
Set the name of the group used to organize and manage links.
memo string
Memo for managing the group.
You can freely record the purpose of the group or management notes.
notfSubscYn string
Default:N
Enum:
YN
Sets whether the link is a push subscription link.
Y: Creates a push subscription–only link, N: Creates a normal link.
When a user accesses a push subscription link, a web push notification subscription request will appear.
qrBypassYn string
Default:N
Enum:
YN
Sets the redirect behavior when accessing via a QR code.
Y: Redirects directly to the original URL. (Click statistics are not recorded)
N: Redirects to the short link URL. (Click statistics are recorded)
blockOverseasSticsYn string
Default:N
Enum:
YN
Sets whether to exclude overseas access statistics.
Y: Overseas access is excluded from statistics.
N: Access from all countries is included in statistics.
pushNotifyYn string
Default:N
Enum:
YN
Sets whether push notifications for click counts are enabled.
Y: A push notification is sent when the defined threshold is reached.
N: No push notification is sent.
This feature is available starting from the Personal plan.
mailNotifyYn string
Default:N
Enum:
YN
Sets whether email notifications for click counts are enabled.
Y: An email notification is sent when the defined threshold is reached.
N: No email notification is sent.
This feature is available starting from the Personal plan.
nonmemberSticsPwd string
Password for viewing click statistics as a non-member.
If you want to allow non-members to view click statistics, set the password required to access the statistics page.
strtYmdt datetime
Link validity start date.
The link can be accessed after the specified date.
Example: 2026-03-01 00:00:00
endYmdt datetime
Link expiration date.
Access to the link will be blocked after the specified date.
Example: 2026-03-31 23:59:59
expireUrl string
URL to redirect to after the link expires.
If not set, a default notification page will be displayed.
Example: https://example.com/event-expired
pwd string
Password required to access the link.
If set, users must enter the password before accessing the destination page.
acesMaxCnt integer
Maximum allowed click count.
If the defined limit is exceeded, access to the link is blocked. (0 means unlimited)
webhookEnableYn string
Default:N
Enum:
YN
Whether Webhook is enabled.
Global Webhook must be activated.
This feature is available only on the Enterprise plan.
webhookCallbackUrl string
Server URL that receives Webhook events.
Required when webhookEnableYn is Y. Enter the endpoint on your server that receives event data.
Example: https://api.example.com/webhook
webhookMetric string
Default:C
Enum:
CP
Webhook trigger metric.
C: Based on click count, P: Based on unique users (unique clicks)
webhookFrequency integer
Default:1
Enum:
1501002003005001000
Webhook trigger frequency.
1: Every click, 50: Every 50 clicks, 100: Every 100 clicks, 300: Every 300 clicks, 500: Every 500 clicks, 1000: Every 1,000 clicks
{
    "code": 0,
    "message": "",
    "result": {
        "grpIdx": 5066,  // group idx
        "webhookSecretKey": null  // When the ‘webhookEnableYn’ parameter is set to ‘Y’, a secret key is specified.
    }
}

Response Parameters

codeinteger
Response code: 0 = Success, any other value = Error
messagestring
Response message. If the response code is not 0, an error-related message is returned.
resultobject
grpIdx integer
Group IDX.
webhookSecretKey string
The secret key is returned when webhookEnableYn is set to Y.