Add a new footer

POST /api/1/footer

1	POST /api/1/footer

Add a new footer to your account. To view default formatting for footers, use the Get footer list API. The default footer (id 0) contains standard elements that you might want to re-use while creating a new footer.

When you add a new footer, Act-On automatically assigns an id. You can, however, assign a meaningful footer title of your choosing.

NOTE: the request must be URL form encoded.

Parameters

Name	Parameter Type	Allow Multiple	Required/ Optional	Data Type	Description
Authorization:	Header	False	Required	String (Bearer {access token})	Pass the authentication token that was granted when you authorized access.
html	form	False	Required	String	Valid HTML for footer. Any graphical elements must be referenced using an absolute path.
text	form	False	Optional	String	Text version of footer for use as alternative.
title	form	False	Required	String	Footer title to use as display title in Act-On user interface.

Request

Following is an example HTTP request:

HTTP

POST /api/1/footer/ HTTP/1.1

1	POST /api/1/footer/ HTTP/1.1

POST /api/1/footer/ HTTP/1.1
Host: restapi.actonsoftware.com
Authorization: Bearer 8133c46115e9cee3952edc193a53a3f5
Cache-Control: no-cache
Content-Type: application/x-www-form-urlencoded

title=alternate-footer&amp;html=%22%3Cp%3E%3Cspan+style%3D%5C%22font-size%3A+14pt%3B%5C%22%3ETest+Footer%3C%2Fspan%3E%3C%2Fp%3E%5C%5C%5Cn%3Cp%3E%3Ca+href%3D%5C%22http%3A%2F%2Fci51.actonsoftware.com%2Facton%2Frif%2F%7B%7BEnv.AccountId%7D%7D%2F%7B%7BEnv.MsgId%7D%7D%2F-%2F%7B%7BEnv.RecId%7D%7D%2F%7B%7BEnv.SrcId%7D%7D%2Fzout%5C%22+target%3D%5C%22_blank%5C%22%3EClick+here+to+opt+out%3C%2Fa%3E%3C%2Fp%3E%22&amp;text=%22Test+Footer%5C%5C%5Cn%5C%5C%5Cn+Click+here+to+opt+out%5C%5C%5Cnhttp%3A%2F%2Fci51.actonsoftware.com%2Facton%2Frif%2F%7B%7BEnv.AccountId%7D%7D%2F%7B%7BEnv.MsgId%7D%7D%2F-%2F%7B%7BEnv.RecId%7D%7D%2F%7B%7BEnv.SrcId%7D%7D%2Fzout%5C%5C%5Cn%5C%5C%5Cn%22

POST /api/1/footer/ HTTP/1.1

Host: restapi.actonsoftware.com

Authorization: Bearer 8133c46115e9cee3952edc193a53a3f5

Cache-Control: no-cache

Content-Type: application/x-www-form-urlencoded

title=alternate-footer&html=%22%3Cp%3E%3Cspan+style%3D%5C%22font-size%3A+14pt%3B%5C%22%3ETest+Footer%3C%2Fspan%3E%3C%2Fp%3E%5C%5C%5Cn%3Cp%3E%3Ca+href%3D%5C%22http%3A%2F%2Fci51.actonsoftware.com%2Facton%2Frif%2F%7B%7BEnv.AccountId%7D%7D%2F%7B%7BEnv.MsgId%7D%7D%2F-%2F%7B%7BEnv.RecId%7D%7D%2F%7B%7BEnv.SrcId%7D%7D%2Fzout%5C%22+target%3D%5C%22_blank%5C%22%3EClick+here+to+opt+out%3C%2Fa%3E%3C%2Fp%3E%22&text=%22Test+Footer%5C%5C%5Cn%5C%5C%5Cn+Click+here+to+opt+out%5C%5C%5Cnhttp%3A%2F%2Fci51.actonsoftware.com%2Facton%2Frif%2F%7B%7BEnv.AccountId%7D%7D%2F%7B%7BEnv.MsgId%7D%7D%2F-%2F%7B%7BEnv.RecId%7D%7D%2F%7B%7BEnv.SrcId%7D%7D%2Fzout%5C%5C%5Cn%5C%5C%5Cn%22

curl

Following is an example curl request:

curl -X POST -H "Authorization: Bearer 8133c46115e9cee3952edc193a53a3f5" -H "Cache-Control: no-cache" -H "Content-Type: application/x-www-form-urlencoded" -d 'title=alternate-footer&amp;html=%22%3Cp%3E%3Cspan+style%3D%5C%22font-size%3A+14pt%3B%5C%22%3ETest+Header%3C%2Fspan%3E%3C%2Fp%3E%5C%5C%5Cn%3Cp%3E%3Ca+href%3D%5C%22http%3A%2F%2Fci51.actonsoftware.com%2Facton%2Frif%2F%7B%7BEnv.AccountId%7D%7D%2F%7B%7BEnv.MsgId%7D%7D%2F-%2F%7B%7BEnv.RecId%7D%7D%2F%7B%7BEnv.SrcId%7D%7D%2Fzout%5C%22+target%3D%5C%22_blank%5C%22%3EClick+here+to+opt+out%3C%2Fa%3E%3C%2Fp%3E%22&amp;text=%22Test+Footer%5C%5C%5Cn%5C%5C%5Cn+Click+here+to+opt+out%5C%5C%5Cnhttp%3A%2F%2Fci51.actonsoftware.com%2Facton%2Frif%2F%7B%7BEnv.AccountId%7D%7D%2F%7B%7BEnv.MsgId%7D%7D%2F-%2F%7B%7BEnv.RecId%7D%7D%2F%7B%7BEnv.SrcId%7D%7D%2Fzout%5C%5C%5Cn%5C%5C%5Cn%22' 'https://restapi.actonsoftware.com/api/1/footer/'

curl -X POST -H "Authorization: Bearer 8133c46115e9cee3952edc193a53a3f5" -H "Cache-Control: no-cache" -H "Content-Type: application/x-www-form-urlencoded" -d 'title=alternate-footer&html=%22%3Cp%3E%3Cspan+style%3D%5C%22font-size%3A+14pt%3B%5C%22%3ETest+Header%3C%2Fspan%3E%3C%2Fp%3E%5C%5C%5Cn%3Cp%3E%3Ca+href%3D%5C%22http%3A%2F%2Fci51.actonsoftware.com%2Facton%2Frif%2F%7B%7BEnv.AccountId%7D%7D%2F%7B%7BEnv.MsgId%7D%7D%2F-%2F%7B%7BEnv.RecId%7D%7D%2F%7B%7BEnv.SrcId%7D%7D%2Fzout%5C%22+target%3D%5C%22_blank%5C%22%3EClick+here+to+opt+out%3C%2Fa%3E%3C%2Fp%3E%22&text=%22Test+Footer%5C%5C%5Cn%5C%5C%5Cn+Click+here+to+opt+out%5C%5C%5Cnhttp%3A%2F%2Fci51.actonsoftware.com%2Facton%2Frif%2F%7B%7BEnv.AccountId%7D%7D%2F%7B%7BEnv.MsgId%7D%7D%2F-%2F%7B%7BEnv.RecId%7D%7D%2F%7B%7BEnv.SrcId%7D%7D%2Fzout%5C%5C%5Cn%5C%5C%5Cn%22' 'https://restapi.actonsoftware.com/api/1/footer/'

Response

A successful request results in an HTTP 200 response in JSON like the following:

{
  "status": "Success",
  "message": "Footer added.",
  "id": "2"
}

{

"status": "Success",

"message": "Footer added.",

"id": "2"

}