curl --request POST \
  --url https://api-prod.heliyos.ai/v1/platform/agents \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Account researcher",
  "description": "Researches a company before a first call and writes a brief on the record.",
  "instructions": "When a meeting is booked with a new company, research it and add a note with its products, recent news and likely priorities.",
  "toolPolicy": {
    "readOnly": false
  },
  "triggers": [
    {
      "type": "event",
      "events": [
        "meeting.booked"
      ]
    },
    {
      "type": "scheduled",
      "match": {
        "schedule": "0 8 * * 1",
        "timezone": "Europe/Berlin"
      }
    }
  ]
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: 'Account researcher',
    description: 'Researches a company before a first call and writes a brief on the record.',
    instructions: 'When a meeting is booked with a new company, research it and add a note with its products, recent news and likely priorities.',
    toolPolicy: {readOnly: false},
    triggers: [
      {type: 'event', events: ['meeting.booked']},
      {type: 'scheduled', match: {schedule: '0 8 * * 1', timezone: 'Europe/Berlin'}}
    ]
  })
};

fetch('https://api-prod.heliyos.ai/v1/platform/agents', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api-prod.heliyos.ai/v1/platform/agents"

payload = {
    "name": "Account researcher",
    "description": "Researches a company before a first call and writes a brief on the record.",
    "instructions": "When a meeting is booked with a new company, research it and add a note with its products, recent news and likely priorities.",
    "toolPolicy": { "readOnly": False },
    "triggers": [
        {
            "type": "event",
            "events": ["meeting.booked"]
        },
        {
            "type": "scheduled",
            "match": {
                "schedule": "0 8 * * 1",
                "timezone": "Europe/Berlin"
            }
        }
    ]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "meta": {
    "message": "Agent created."
  },
  "data": {
    "_id": "6720f3a1b2c3d4e5f6a7b8c9",
    "organizationId": "66a0f1e2d3c4b5a697887766",
    "name": "Account researcher",
    "type": "custom",
    "isActive": true,
    "isExcluded": false,
    "description": "Researches a company before a first call and writes a brief on the record.",
    "instructions": "When a meeting is booked with a new company, research it and add a note with its products, recent news and likely priorities.",
    "toolName": "account_researcher",
    "toolNames": [],
    "actionIds": [],
    "toolPolicy": {
      "readOnly": false
    },
    "memory": {
      "enabled": true
    },
    "resources": {
      "scope": "everything",
      "allKbFiles": true,
      "linkedKbFileIds": [],
      "fileIds": []
    },
    "triggers": [
      {
        "type": "event",
        "events": [
          "meeting.booked"
        ],
        "source": "user"
      },
      {
        "type": "scheduled",
        "events": [],
        "match": {
          "schedule": "0 8 * * 1",
          "timezone": "Europe/Berlin"
        },
        "dependencies": [],
        "source": "user"
      }
    ],
    "runtime": "sandbox",
    "metadata": {
      "created": {
        "at": "2026-11-05T10:00:00.000Z",
        "by": "66a0f1e2d3c4b5a697881111"
      },
      "updated": {
        "at": "2026-11-05T10:00:00.000Z",
        "by": "66a0f1e2d3c4b5a697881111"
      }
    },
    "createdAt": "2026-11-05T10:00:00.000Z",
    "updatedAt": "2026-11-05T10:00:00.000Z",
    "scheduleSync": {
      "created": [
        "6729c0d1e2f3a4b5c6d7e8f9"
      ],
      "deleted": [],
      "failed": []
    }
  }
}

{
  "message": "<string>",
  "error": {
    "code": "VALIDATION_FAILED",
    "message": "<string>",
    "details": "<unknown>"
  }
}

{
  "message": "<string>",
  "error": {
    "code": "VALIDATION_FAILED",
    "message": "<string>",
    "details": "<unknown>"
  }
}

{
  "message": "<string>",
  "error": {
    "code": "VALIDATION_FAILED",
    "message": "<string>",
    "details": "<unknown>"
  }
}

{
  "message": "<string>",
  "error": {
    "code": "VALIDATION_FAILED",
    "message": "<string>",
    "details": "<unknown>"
  }
}

{
  "message": "<string>",
  "error": {
    "code": "VALIDATION_FAILED",
    "message": "<string>",
    "details": "<unknown>"
  }
}

{
  "message": "<string>",
  "error": {
    "code": "VALIDATION_FAILED",
    "message": "<string>",
    "details": "<unknown>"
  }
}