API referenceLists
Create a list
409 `list_exists` when the workspace has a list of that name.
POST
409 list_exists when the workspace has a list of that name.
apiKey writeheader
AuthorizationBearer <token>A workspace API key (pf_…), created under Developers → API keys.
Scope: write
idempotency-key?stringRun this write once: a retry with the same key gets the first answer (24 hours).
Length
1 <= length <= 255application/json- body
name*stringLength
1 <= length <= 100description?|Length
length <= 500Default
nullfolderId?|Match
^(folder)_[0-9A-Za-z]{8}$Default
nullCreated
application/json- response
id*stringMatch
^(list)_[0-9A-Za-z]{8}$name*stringdescription*string|nullfolder*|The folder it’s in; null at the top level
profilesCount*integercreatedAt*stringFormat
date-timeupdatedAt*stringFormat
date-timecurl -X POST 'https://api.postforge.dev/v1/lists' \ -H 'Content-Type: application/json' \ -d '{ "name": "string"}'{ "id": "string", "name": "string", "description": "string", "folder": { "id": "string", "name": "string" }, "profilesCount": 0, "createdAt": "2019-08-24T14:15:22Z", "updatedAt": "2019-08-24T14:15:22Z"}