FOfolk
Groups

Create a group

Changed on

Create a new group in the workspace. A default "All people" table view is automatically created for the group.

post/v1/groups

Request

  • Base URL
    https://api.folk.app
  • URL
    https://api.folk.app/v1/groups
  • Auth
    HTTP bearer

Headers

Idempotency-Keystring

A unique key, such as a UUID, that makes retrying this request safe: a retry with the same key and body returns the original response without running the operation again. Keys are kept for 24 hours after the request completes.

Example:8e03978e-40d5-43e8-bc93-6894a57f9324

Request body

namestring required

The name of the group.

visibility'public' | 'private' required

The visibility of a group.

  • public: The group is visible to all users in the workspace.
  • private: The group is visible only to explicitly added group members.
emojistring emoji

The emoji of the group, as a single native emoji. A random default emoji is used when omitted.

Example request

{
  "name": "Investors",
  "emoji": "🤝"
}

Response

The group created in the workspace.

deprecationsstring[]

Example response

{
  "data": {
    "id": "grp_bc984b3f-0386-434d-82d7-a91eb6badd71",
    "name": "Group Name",
    "visibility": "private",
    "createdBy": "usr_abc84b3f-0386-434d-82d7-a91eb6bad999",
    "emoji": "🤝"
  },
  "deprecations": [
    "This field is deprecated"
  ]
}

Changes