Welcome
- Introduction
- Understanding enriched data
- Integrating
Enrichment Guides
- Overview
- Enhanced data fields
- Batch enrichment guide
Tooling Guides
- Merchant matching
- Merchant search guide
- Category personalization guide
Spade API
- Card Enrichment
- Transfer Enrichment
- Feedback and Reporting
- Merchant Search
- Merchant Matching
- Category Personalization
- GETGet all default and custom integration-level categories
- POSTCreate a custom integration-level category
- DELDelete all custom integration-level categories
- DELDelete a custom integration-level category
- GETGet all integration-level counterparty category personalizations
- PUTCreate an integration-level counterparty category personalization
- DELDelete all integration-level counterparty category personalizations
- DELDelete a counterparty category personalization
- GETGet categories
- POSTCreate a custom user-level category
- DELDelete all custom user-level categories
- DELDelete a custom user-level category
- GETGet all user-level counterparty category personalizations
- PUTCreate a user-level counterparty category personalization
- DELDelete all user-level counterparty category personalizations
- DELDelete a user-level counterparty category personalization
- GET
More
- User experience
- Understanding match scores
- Glossary
- FAQ
Category Personalization
Create a custom user-level category
Create a custom user-level category.
To learn more about user category personalization, please read the User Category Personalization Guide.
POST
/
users
/
{userId}
/
categories
Copy
Ask AI
curl --request POST \
--url https://east.sandbox.spade.com/users/{userId}/categories \
--header 'Content-Type: application/json' \
--header 'X-Api-Key: <api-key>' \
--data '{
"name": "Kitchen Remodel",
"parentId": "011-000-000-000"
}'
Copy
Ask AI
{
"id": "4d5419f1-bcde-40f5-9168-7f8989b9c55f",
"name": "Kitchen Remodel",
"icon": "https://static.v2.spadeapi.com/categories/ee4ee39fd5474d31ac42f9e606b9040a/light.png",
"fullCategoryHierarchy": [
{
"id": "011-000-000-000",
"name": "Retail",
"icon": "https://static.v2.spadeapi.com/categories/ee4ee39fd5474d31ac42f9e606b9040a/light.png"
},
{
"id": "4d5419f1-bcde-40f5-9168-7f8989b9c55f",
"name": "Kitchen Remodel",
"icon": "https://static.v2.spadeapi.com/categories/ee4ee39fd5474d31ac42f9e606b9040a/light.png"
}
]
}
Authorizations
Path Parameters
The userId
of the relevant user.
Body
application/json
Schema for creating a custom category.
Response
201
application/json
Successful operation
The newly created category.
Copy
Ask AI
curl --request POST \
--url https://east.sandbox.spade.com/users/{userId}/categories \
--header 'Content-Type: application/json' \
--header 'X-Api-Key: <api-key>' \
--data '{
"name": "Kitchen Remodel",
"parentId": "011-000-000-000"
}'
Copy
Ask AI
{
"id": "4d5419f1-bcde-40f5-9168-7f8989b9c55f",
"name": "Kitchen Remodel",
"icon": "https://static.v2.spadeapi.com/categories/ee4ee39fd5474d31ac42f9e606b9040a/light.png",
"fullCategoryHierarchy": [
{
"id": "011-000-000-000",
"name": "Retail",
"icon": "https://static.v2.spadeapi.com/categories/ee4ee39fd5474d31ac42f9e606b9040a/light.png"
},
{
"id": "4d5419f1-bcde-40f5-9168-7f8989b9c55f",
"name": "Kitchen Remodel",
"icon": "https://static.v2.spadeapi.com/categories/ee4ee39fd5474d31ac42f9e606b9040a/light.png"
}
]
}
Assistant
Responses are generated using AI and may contain mistakes.