Create a new category

post https://app.pennylane.com/api/external/v1/categories

This endpoint returns the created category.

Responses

Response body

object

category

object

integer

required

Category unique ID

source_id

string

Category unique UUID identifier

group_source_id

string

Group unique UUID identifier

group_v2_id

integer

The corresponding identifier for the category group in the V2 API.
This field is provided to facilitate migration from V1 to V2 API by allowing mapping
between V1 and V2 identifiers. When transitioning to V2 endpoints, use this value
instead of the V1 id or source_id.

group_label

string

Category group name

label

string

Category name (is unique per group of categories)

direction

string | null

cash_in cash_out

is_editable

boolean

created_at

date-time

Category created date

updated_at

date-time

Category created date

v2_id

integer

The corresponding identifier for this resource in the V2 API.
This field is provided to facilitate migration from V1 to V2 API by allowing mapping
between V1 and V2 identifiers. When transitioning to V2 endpoints, use this value
instead of the V1 id or source_id.

Language

Credentials

OAuth2


xxxxxxxxxx
1
curl --request POST \
2
     --url https://app.pennylane.com/api/external/v1/categories \
3
     --header 'accept: application/json' \
4
     --header 'content-type: application/json'


xxxxxxxxxx
15
 
1
{
2
  "category": {
3
    "id": 42,
4
    "source_id": "38a1f19a-256d-4692-a8fe-0a16403f59ff",
5
    "group_source_id": "03b961bb-09ad-4789-b1c3-a77875773b82",
6
    "group_v2_id": 1234,
7
    "group_label": "Category Group Label",
8
    "label": "Alimentaire",
9
    "direction": "cash_in",
10
    "is_editable": true,
11
    "created_at": "2023-08-30T10:08:08.146343Z",
12
    "updated_at": "2023-08-30T10:08:08.146343Z",
13
    "v2_id": 1234
14
  }
15
}

201Returns the created category

400Bad Request

401Access token is missing or invalid

403Forbidden

422Unprocessable Entity