---
title: "Save credentials"
method: POST
path: "/v1/credentials"
tags: ["Credentials"]
---

# Save credentials

`POST /v1/credentials`

## Request

- Base URL: `https://api.postlake.dev`
- URL: `https://api.postlake.dev/v1/credentials`
- Auth: `bearerAuth` (a scheme the document does not define)

Save BYO platform app credentials for supported networks other than X. X always uses PostLake's shared app; customer-owned X app credentials are rejected.

## Request body

- object
  - `platform` 'bluesky' | 'threads' | 'x' | 'linkedin' | 'instagram' | 'tiktok' | 'facebook' | 'youtube' | 'pinterest', required
  - `clientId` string, required
  - `clientSecret` string, required

## Response `201`

Created

- object
  - `credential` Credential, required
    - `platform` 'bluesky' | 'threads' | 'x' | 'linkedin' | 'instagram' | 'tiktok' | 'facebook' | 'youtube' | 'pinterest', required
    - `clientId` string, required
    - `createdAt` string, date-time, required

## Other responses

- `400`: Invalid platform or missing credentials
- `401`: Unauthorized

---

[API](https://skmtc.dev/postlake/apis/postlake-api.md) · [All operations](https://skmtc.dev/postlake/apis/postlake-api/llms.txt) · [OpenAPI document](https://skmtc.dev/postlake/apis/postlake-api/revisions/f81060e31f69?raw)