Update Link Group

Update settings for an existing link group.
A link group allows you to organize and manage multiple short links under a single group.

Use this API when you need to change the name or configuration of a group that has already been created.
Settings such as expiration date, click limits, password protection, notifications, and analytics can be updated at the group level.

When a group configuration is updated, the changes are applied to all links that belong to that group.
If both link-level and group-level settings exist, the group settings take precedence.

Organizing links by campaign, project, or marketing channel makes it easier to analyze performance and manage links efficiently at the group level.

PUT

/api/link-group/v1/update

{
    "grpIdx": 5066,
    "nm": "Instagram Group",
    "memo": "A group of links used in Instagram ads.",
    "strtYmdt": "2026-03-01 00:00:00",
    "endYmdt": "2026-03-31 23:59:59",
    "expireUrl": "https://example.com/event-expired"
}

Request Parameters

grpIdx integer required
Group IDX.
Specify the IDX of the group you want to update.
nm string
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": null  // When the ‘webhookEnableYn’ parameter is set to ‘Y’, a secret key is specified.
}

Response Parameters

code integer
Response code: 0 = Success, other values = Error
message string
Response message. If the response code is not 0, an error message is returned.
result string
webhookEnableYn is set to Y, a secret key is generated and returned.
If a webhookSecretKey already exists for the group, a new key will not be generated or returned.