I tries to create SSJS activity using REST API. Body of request looks like this:

    "name": "ActivityName",
    "key": "ActivityKey",
    "description": "",
    "script": "Blablabla",
    "categoryId": 123456

But, categoryId field is required, and I don't know how I can get it using API (any API). So, the question is: how to get categoryId of SSJS activities? Ideally is to retrieve root categoryId, but honestly, I hope to get at least any categoryId through API

1 Answer 1


You can get a list of your SSJS Activities folder via the category type of ssjsactivity on the folder structure endpoint:

GET /email/v1/categories?catType=ssjsactivity
Host: {{subDomain}}.rest.marketingcloudapis.com
Authorization: Bearer {{auth_token}}
Content-Type: application/json

This will return an array of the folders and IDs of your SSJS Activities. Like below:

    "count": 1,
    "page": 1,
    "pageSize": 50,
    "links": {
        "self": {
            "href": "/v1/categories/?catType=ssjsactivity&$page=1&$pageSize=50"
    "items": [
            "categoryId": 123456,
            "parentCatId": 0,
            "modifiedBy": XXXXXXX,
            "objectId": "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx",
            "createDate": "2029-12-09T12:33:28.133",
            "modifiedDate": "2029-12-09T12:33:28.133",
            "catType": "SSJSActivity",
            "name": "Scripts",
            "categoryDesc": "",
            "iconType": "SSJSActivity"
  • thanks a lot, that forks just fine. can you help me one more time? do you know what is catType for query activities? cause I also need this done for query activities as well Mar 2, 2021 at 8:54
  • 1
    Found it, it's queryactivity Mar 2, 2021 at 9:00

You must log in to answer this question.

Not the answer you're looking for? Browse other questions tagged .