POST api/v2/admin/tasks/account

Creates a new task for the account. Before a new task can be created a client must have been created before hand.

Request Information

URI Parameters

None.

Body Parameters

The details of the task to be created.

TwoSms.CustomerPortalRole.API.Admin.Tasks.AccountTaskRequest

Name	Description	Type	Additional information
TaskID	The ID of the task to be registered.	globally unique identifier	Required
Frequency	How often the task should run.	TwoSms.Platform.Database.CustomerPortal.Tables.Task.Frequency	Required
StartDate	Determines when the task should start running.	date	None.
FinishDate	Determines when the task should stop running.	date	None.
Parameters	The parameters for the task.	string	Required
ContentType	The format the parameters are in. Must either be application/xml or application/json.	string	Required
Notification	Determines the notifications the task could send back to the user.	TwoSms.Platform.Database.CustomerPortal.Tables.Task.TaskNotification	None.

Request Formats

application/json, text/json

Sample:

{
  "TaskID": "d795ed5c-b1ee-40ea-813a-7951c0b15ae0",
  "Frequency": 0,
  "StartDate": "2026-01-07T12:04:00.9101555+00:00",
  "FinishDate": "2026-01-07T12:04:00.9101555+00:00",
  "Parameters": "sample string 3",
  "ContentType": "sample string 4",
  "Notification": 0
}

application/xml, text/xml

Sample:

<AccountTaskRequest xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <TaskID>d795ed5c-b1ee-40ea-813a-7951c0b15ae0</TaskID>
  <Frequency>NONE</Frequency>
  <StartDate>2026-01-07T12:04:00.9101555+00:00</StartDate>
  <FinishDate>2026-01-07T12:04:00.9101555+00:00</FinishDate>
  <Parameters>sample string 3</Parameters>
  <ContentType>sample string 4</ContentType>
  <Notification>NONE</Notification>
</AccountTaskRequest>

application/x-www-form-urlencoded

Sample:

Failed to generate the sample for media type 'application/x-www-form-urlencoded'. Cannot use formatter 'System.Web.Http.ModelBinding.JQueryMvcFormUrlEncodedFormatter' to write type 'TwoSms.CustomerPortalRole.API.Admin.Tasks.AccountTaskRequest'.

Response Information

Resource Description

The task details with its ID field populated.

TwoSms.CustomerPortalRole.API.Misc.ResponseOfTwoSms.CustomerPortalRole.API.Admin.Tasks.AccountTaskResponse

Name	Description	Type	Additional information
Error		TwoSms.CustomerPortalRole.API.Misc.Error	None.
ResponseData		TwoSms.CustomerPortalRole.API.Misc.ResponseDataOfTwoSms.CustomerPortalRole.API.Admin.Tasks.AccountTaskResponse	None.

Response Formats

application/json, text/json

Sample:

{
  "Error": {
    "ErrorCode": "sample string 1",
    "ErrorReason": "sample string 2"
  },
  "ResponseData": {
    "Identification": {
      "UserId": "sample string 1"
    },
    "Result": "sample string 1",
    "Detail": {
      "ID": "a9da0650-5a8b-494a-94c9-28a5db3d497b",
      "TaskID": "6e7f0b5e-b23e-40bb-986e-d710f0d4843f",
      "Name": "sample string 3",
      "Enabled": true,
      "Frequency": "sample string 5",
      "StartDate": "2026-01-07T12:04:00.9181635+00:00",
      "FinishDate": "2026-01-07T12:04:00.9181635+00:00",
      "Parameters": "sample string 7",
      "ContentType": "sample string 8",
      "Notification": "sample string 9",
      "DateCreated": "2026-01-07T12:04:00.9181635+00:00",
      "DateModified": "2026-01-07T12:04:00.9181635+00:00",
      "LastRunOn": "2026-01-07T12:04:00.9181635+00:00",
      "LastRunBy": "sample string 11",
      "LastModifiedBy": "sample string 12",
      "Status": "sample string 13",
      "ClientID": "ec511620-00d3-4a43-8e38-86cd0d3410d8"
    }
  }
}