Connect links

List connect links

GEThttps://hivepost.app/v1/connect-links

Newest first. Test keys list test links; live keys list live links.

Query

limitinteger
1 to 100. Default 20.
cursorstring
next_cursor from the previous page.
statusstring
One of open, used, expired, revoked
external_idstring
Up to 255 characters.

Returns

200 A page of links.

Errors

Status	Code	When
401	`unauthorized`	No API key, or one that isn't valid (`unauthorized`).
403	`forbidden`, `drafts_only`, `network_not_available`	The key can't do this (`forbidden`, `drafts_only`), or the network isn't open in the API (`network_not_available`).
422	`validation_failed`, `return_url_not_allowed`, `account_not_connected`, `text_too_long`, `media_required`, `time_in_past`	A field is wrong (`validation_failed`), a connect link's `return_url` isn't on an allowed domain (`return_url_not_allowed`), an account needs reconnecting (`account_not_connected`), or a network refuses the post as it is (e.g. `text_too_long`, `media_required`, `time_in_past`). `details` lists each problem with the account it is about.
429	`rate_limited`	More than 60 requests in a minute (`rate_limited`).
500	`internal_error`	Something went wrong on our side (`internal_error`). Safe to retry with the same Idempotency-Key.

import os import requests res = requests.get( "https://hivepost.app/v1/connect-links", headers={ "Authorization": f"Bearer {os.environ['HIVEPOST_API_KEY']}", }, ) print(res.status_code, res.json())

{ "object": "list", "data": [ { "id": "8c1f4a52-6f0e-4d1b-9a43-2d7e5b0c9f21", "object": "connect_link", "mode": "test", "status": "open", "url": "https://hivepost.app/connect/hpcl_9QdbB2fV0nWx3kLm7pRt4sYzA1b2C3d4", "external_id": "customer_0142", "networks": ["bluesky"], "brand_id": "0b6d2c1e-3f4a-4e5b-8c7d-9a1b2c3d4e5f", "return_url": "https://shop.example.com/accounts/done", "account_id": null, "opened_at": null, "used_at": null, "expires_at": "2026-11-12T10:00:00Z", "created_at": "2026-11-12T10:00:00Z" } ], "has_more": false, "next_cursor": null }