Accounts

Connected social accounts, whether they can post, and their boards, playlists and subreddits.

List connected accounts

GET/v1/accounts

Parameters

profileIdstring

Response 200

data []

idstringrequired
profileIdstringrequired
platformstringrequired
usernamestring
displayNamestring
avatarUrlstring (uri)
statusstringrequired
Values: active · needs_reconnection · disconnected
connectedAtstring (date-time)required
updatedAtstring (date-time)required

curl "https://api.usecrier.com/v1/accounts?profileId=prf_8f2k4d" \
  -H "Authorization: Bearer $CRIER_API_KEY"

const res = await fetch('https://api.usecrier.com/v1/accounts?profileId=prf_8f2k4d', {
  headers: {
    Authorization: `Bearer ${process.env.CRIER_API_KEY}`,
  },
});
const { data } = await res.json();

import os, requests

res = requests.get(
    "https://api.usecrier.com/v1/accounts?profileId=prf_8f2k4d",
    headers={"Authorization": f"Bearer {os.environ['CRIER_API_KEY']}"},
)
data = res.json()["data"]

Check whether accounts can post

GET/v1/accounts/health

Asks each network right now. Accounts that need reconnecting are updated to needs_reconnection.

Parameters

profileIdstringrequired

Response 200

data []

accountIdstringrequired
platformstringrequired
statusstringrequired
Values: healthy · warning · error
canPostbooleanrequired
needsReconnectionbooleanrequired
issuesstring[]required

curl "https://api.usecrier.com/v1/accounts/health?profileId=prf_8f2k4d" \
  -H "Authorization: Bearer $CRIER_API_KEY"

const res = await fetch('https://api.usecrier.com/v1/accounts/health?profileId=prf_8f2k4d', {
  headers: {
    Authorization: `Bearer ${process.env.CRIER_API_KEY}`,
  },
});
const { data } = await res.json();

import os, requests

res = requests.get(
    "https://api.usecrier.com/v1/accounts/health?profileId=prf_8f2k4d",
    headers={"Authorization": f"Bearer {os.environ['CRIER_API_KEY']}"},
)
data = res.json()["data"]

List boards, playlists, subreddits or flairs

GET/v1/accounts/{id}/{kind}

kind is pinterest-boards, youtube-playlists, reddit-subreddits or reddit-flairs (with subreddit). Use the ids in the post options.

Parameters

idstringrequired
kindstringrequired
Values: pinterest-boards · youtube-playlists · reddit-subreddits · reddit-flairs
subredditstring
Required for reddit-flairs.

Response 200

data []

idstringrequired
Send it as boardId, playlistId, subreddit or flairId.
namestringrequired
detailstring
isDefaultboolean
The account's default, used when a post does not pick one.

curl "https://api.usecrier.com/v1/accounts/acc_3k9x2m/{kind}" \
  -H "Authorization: Bearer $CRIER_API_KEY"

const res = await fetch('https://api.usecrier.com/v1/accounts/acc_3k9x2m/{kind}', {
  headers: {
    Authorization: `Bearer ${process.env.CRIER_API_KEY}`,
  },
});
const { data } = await res.json();

import os, requests

res = requests.get(
    "https://api.usecrier.com/v1/accounts/acc_3k9x2m/{kind}",
    headers={"Authorization": f"Bearer {os.environ['CRIER_API_KEY']}"},
)
data = res.json()["data"]

Disconnect an account

DELETE/v1/accounts/{id}

Parameters

idstringrequired

Response 204

No content

curl -X DELETE "https://api.usecrier.com/v1/accounts/acc_3k9x2m" \
  -H "Authorization: Bearer $CRIER_API_KEY"

await fetch('https://api.usecrier.com/v1/accounts/acc_3k9x2m', {
  method: 'DELETE',
  headers: {
    Authorization: `Bearer ${process.env.CRIER_API_KEY}`,
  },
});

import os, requests

requests.delete(
    "https://api.usecrier.com/v1/accounts/acc_3k9x2m",
    headers={"Authorization": f"Bearer {os.environ['CRIER_API_KEY']}"},
)