TwentyThree Developer APIAPI Method: /api/action/add

API Method: /api/action/add

Last updated on December 22, 2013.

Add a new call-to-action, with the default values set for the action type. If you want to set custom action data, use /api/action/update after calling this method.

Parameters

ParameterDescription
type (required) The type of the call to action.
object_id (required) The object ID the call to action is connected to. This may be a `photo` object, an `album` object, a `site` or a `player`.

Permission level

The minimum required permission level is:

write

Example XML Response

<response status="ok" permission_level="write" 
  message="The action was created" cached="0"/>

Example JSON Response

{
  "status": "ok", 
  "message":"The action was created",
  "permission_level":"write",
  "cached":"0",
  "action":{},
  "p": "1",
  "size": "1",
  "site": { ... },
  "endpoint": "/api/action/add"
}