List activation connect links Public Preview

This endpoint returns details for all active and expired activation Connect Links. Read more on how to use Connect Links in our Activations in Powered by Fivetran How-to Guides.

Request schema

Query parameters

page

number

Designates which page of results to return. Always starts at 1. If 0 is specified, it defaults to 1.

default:

per_page

number

Determines the number of results on each page. It can't exceed 100.

default:

maximum:

100

order

string

Organizes the results based on their creation time, either ascending or descending.

default:

desc

enum:

"asc""desc"

Header parameters

Authorization

stringrequired

HTTP: basicAuth

HTTP AuthorizationScheme: basic

Http + 1.1

GET

https://app.getcensus.com/api/v2/activation_connect_links

GET /api/v2/activation_connect_links?page=SOME_NUMBER_VALUE&per_page=SOME_NUMBER_VALUE&order=SOME_STRING_VALUE HTTP/1.1
Authorization: Bearer REPLACE_BEARER_TOKEN
Host: app.getcensus.com

Responses

200

Successfully retrieved the list of activation connect links.

401

Invalid credentials for the requested resource.

`200`

status

stringrequired

The outcome of the request

enum:

"success"

pagination

objectrequired

An object to help you navigate the list of results.

total_records

number

Total records in the collection.

example:

per_page

number

Records on each page.

default:

example:

prev_page

number | null

The previous page number, or null for the first page.

example:

page

number

The current page number.

default:

example:

next_page

number | null

The next page number, or null if it's the last page.

example:

last_page

number

The number of the last page with records.

example:

data

arrayrequired

The list of results.

integerrequired

The unique ID associated with the Connect Link.

example:

469

type

string

The type of activation to be managed by this link.

example:

hubspot

expiration

stringrequired

The date and time when the Connect Link will expire.

format:

date-time

example:

2027-09-28T23:42:47.239Z

expired

boolean

A boolean value indicating whether the Connect Link has expired or not.

revoked

booleanrequired

A boolean value indicating whether the Connect Link has been revoked or not.

uri

stringrequired

The authorization URL that you will provide to end-users that begins the Fivetran-hosted flow to authorize an activation into your workspace.

format:

uri

example:

https://app.fivetran.com/pbc?auth=expiring_auth_key

redirect_uri

string | null

The redirect URI, if any, associated with the Connect Link. The URL that you'd like the end-user to be redirected to after authorizing the activation. We do not forward the OAuth code or token to this URL.

format:

uri

example:

https://your-app.example.com/oauth/callback

group_id

string

The unique identifier of the group associated with this Connect Link.

example:

wandering_aimlessly

`401`

status

integer

HTTP status code.

enum:

"401"

{
  "status": "success",
  "pagination": {
    "total_records": 14,
    "per_page": 25,
    "prev_page": 1,
    "page": 2,
    "next_page": 3,
    "last_page": 10
  },
  "data": [
    {
      "id": 469,
      "type": "hubspot",
      "expiration": "2027-09-28T23:42:47.239Z",
      "expired": false,
      "revoked": false,
      "uri": "https://app.fivetran.com/pbc?auth=expiring_auth_key",
      "redirect_uri": "https://your-app.example.com/oauth/callback",
      "group_id": "wandering_aimlessly"
    }
  ]
}