PingOne Platform APIs

Create Branding Theme

 

POST {{apiPath}}/environments/{{envID}}/themes

The POST {{apiPath}}/environments/{{envID}}/themes endpoint creates a new branding configuration theme associated with the specified environment resource.

Prerequisites

  • Create an image to get an {{imageID}} and {{logoID}}. Refer to Create Image. Alternatively, you can pass new href values that are valid images for configuration.logo.href and configuration.backgroundImage.href, and use new {{logoID}} and {{imageID}} values if they are in the correct format: 00000000-0000-0000-0000-000000000000.

  • Refer to Branding and Branding Themes for important overview information.

Request Model

For property descriptions, refer to Branding theme data model.

Property Type Required?

configuration.backgroundColor

String

Required

configuration.backgroundType

String

Required

configuration.backgroundImage.href

String

Required

configuration.backgroundImage.id

String

Required

configuration.bodyTextColor

String

Optional

configuration.buttonColor

String

Optional

configuration.buttonTextColor

String

Optional

configuration.cardColor

String

Optional

configuration.footer

String

Optional

configuration.headingTextColor

String

Optional

configuration.linkTextColor

String

Optional

configuration.logo.href

String

Required

configuration.logo.id

String

Required

configuration.logoType

String

Required

configuration.name

String

Optional

default

Boolean

Required

template

String

Required

Headers

Authorization      Bearer {{accessToken}}

Content-Type      application/json

Body

raw ( application/json )

{
    "template": "slate",
    "default": false,
    "configuration": {
        "logoType": "IMAGE",
        "logo": {
            "href": "https://d3uinntk0mqu3p.cloudfront.net/branding/market/a3d073bc-3108-49ad-b96c-404bea59a1d0.png",
            "id": "00000000-0000-0000-0000-000000000000"
        },
        "applicationBackgroundColor": "#f8f8f8",
        "backgroundType": "DEFAULT",
        "bodyTextColor": "#4C4C4C",
        "cardColor": "#FFFFFF",
        "headingTextColor": "#4A4A4A",
        "linkTextColor": "#5F5F5F",
        "buttonColor": "#4A4A4A",
        "buttonTextColor": "#FFFFFF",
        "name": "Custom Slate v2",
        "footer": "<p>Copyright © 2025 My Company</p>",
        "backgroundOutlineColor": "#4A4A4A",
        "foregroundMainColor": "#4A4A4A",
        "foregroundHighlightColor": "#4A4A4A",
        "schemaVersion": 2,
        "buttonBorderColor": "#4A4A4A",
        "focusRectangleColor": "#D033FF",
        "buttonHoverStateFillColor": "#4A4A4A",
        "buttonHoverStateBorderColor": "#4A4A4A",
        "buttonHoverStateTextColor": "#FFFFFF",
        "subTitleTextColor": "#4A4A4A",
        "titleTextColor": "#4A4A4A",
        "linkTextHoverColor": "#007CBA",
        "inputLabelTextColor": "#798087",
        "inputBoxBorderColor": "#4A4A4A",
        "cardBorderColor": "#CACED3",
        "globalFont": "\"Helvetica Neue\", Helvetica, sans-serif",
        "logoHeight": "56px",
        "buttonBorderWidth": "1px",
        "buttonCornerRadius": "2px",
        "buttonTextSize": "18px",
        "buttonTextWeight": "400",
        "titleTextSize": "20px",
        "titleTextWeight": "600",
        "subTitleTextSize": "15px",
        "subTitleTextWeight": "400",
        "bodyTextSize": "15px",
        "bodyTextWeight": "400",
        "linkTextSize": "15px",
        "linkTextWeight": "400",
        "inputLabelTextSize": "15px",
        "inputLabelTextWeight": "600",
        "inputValueTextSize": "15px",
        "inputValueTextWeight": "600",
        "inputValueTextColor": "#798087",
        "inputBorderWidth": "1px",
        "inputCornerRadius": "0px",
        "inputLabelPosition": "float",
        "cardBorderWidth": "0px",
        "cardCornerRadius": "0px",
        "cardShadow": "0px",
        "cardHorizontalAlignment": "left",
        "cardVerticalAlignment": "center",
        "footerLocalized": {
            "enabled": true,
            "defaultLanguage": "en",
            "contentType": "HTML",
            "content": {
                "en": {
                    "inputText": "<p>Copyright © 2025 My Company</p>"
                }
            }
        },
        "cardLogoAlignment": "left"
    }
}

Example Request

  • cURL

  • C#

  • Go

  • HTTP

  • Java

  • jQuery

  • NodeJS

  • Python

  • PHP

  • Ruby

  • Swift

curl --location --globoff '{{apiPath}}/environments/{{envID}}/themes' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{accessToken}}' \
--data '{
    "template": "slate",
    "default": false,
    "configuration": {
        "logoType": "IMAGE",
        "logo": {
            "href": "https://d3uinntk0mqu3p.cloudfront.net/branding/market/a3d073bc-3108-49ad-b96c-404bea59a1d0.png",
            "id": "00000000-0000-0000-0000-000000000000"
        },
        "applicationBackgroundColor": "#f8f8f8",
        "backgroundType": "DEFAULT",
        "bodyTextColor": "#4C4C4C",
        "cardColor": "#FFFFFF",
        "headingTextColor": "#4A4A4A",
        "linkTextColor": "#5F5F5F",
        "buttonColor": "#4A4A4A",
        "buttonTextColor": "#FFFFFF",
        "name": "Custom Slate v2",
        "footer": "<p>Copyright © 2025 My Company</p>",
        "backgroundOutlineColor": "#4A4A4A",
        "foregroundMainColor": "#4A4A4A",
        "foregroundHighlightColor": "#4A4A4A",
        "schemaVersion": 2,
        "buttonBorderColor": "#4A4A4A",
        "focusRectangleColor": "#D033FF",
        "buttonHoverStateFillColor": "#4A4A4A",
        "buttonHoverStateBorderColor": "#4A4A4A",
        "buttonHoverStateTextColor": "#FFFFFF",
        "subTitleTextColor": "#4A4A4A",
        "titleTextColor": "#4A4A4A",
        "linkTextHoverColor": "#007CBA",
        "inputLabelTextColor": "#798087",
        "inputBoxBorderColor": "#4A4A4A",
        "cardBorderColor": "#CACED3",
        "globalFont": "\"Helvetica Neue\", Helvetica, sans-serif",
        "logoHeight": "56px",
        "buttonBorderWidth": "1px",
        "buttonCornerRadius": "2px",
        "buttonTextSize": "18px",
        "buttonTextWeight": "400",
        "titleTextSize": "20px",
        "titleTextWeight": "600",
        "subTitleTextSize": "15px",
        "subTitleTextWeight": "400",
        "bodyTextSize": "15px",
        "bodyTextWeight": "400",
        "linkTextSize": "15px",
        "linkTextWeight": "400",
        "inputLabelTextSize": "15px",
        "inputLabelTextWeight": "600",
        "inputValueTextSize": "15px",
        "inputValueTextWeight": "600",
        "inputValueTextColor": "#798087",
        "inputBorderWidth": "1px",
        "inputCornerRadius": "0px",
        "inputLabelPosition": "float",
        "cardBorderWidth": "0px",
        "cardCornerRadius": "0px",
        "cardShadow": "0px",
        "cardHorizontalAlignment": "left",
        "cardVerticalAlignment": "center",
        "footerLocalized": {
            "enabled": true,
            "defaultLanguage": "en",
            "contentType": "HTML",
            "content": {
                "en": {
                    "inputText": "<p>Copyright © 2025 My Company</p>"
                }
            }
        },
        "cardLogoAlignment": "left"
    }
}'
var options = new RestClientOptions("{{apiPath}}/environments/{{envID}}/themes")
{
  MaxTimeout = -1,
};
var client = new RestClient(options);
var request = new RestRequest("", Method.Post);
request.AddHeader("Content-Type", "application/json");
request.AddHeader("Authorization", "Bearer {{accessToken}}");
var body = @"{" + "\n" +
@"    ""template"": ""slate""," + "\n" +
@"    ""default"": false," + "\n" +
@"    ""configuration"": {" + "\n" +
@"        ""logoType"": ""IMAGE""," + "\n" +
@"        ""logo"": {" + "\n" +
@"            ""href"": ""https://d3uinntk0mqu3p.cloudfront.net/branding/market/a3d073bc-3108-49ad-b96c-404bea59a1d0.png""," + "\n" +
@"            ""id"": ""00000000-0000-0000-0000-000000000000""" + "\n" +
@"        }," + "\n" +
@"        ""applicationBackgroundColor"": ""#f8f8f8""," + "\n" +
@"        ""backgroundType"": ""DEFAULT""," + "\n" +
@"        ""bodyTextColor"": ""#4C4C4C""," + "\n" +
@"        ""cardColor"": ""#FFFFFF""," + "\n" +
@"        ""headingTextColor"": ""#4A4A4A""," + "\n" +
@"        ""linkTextColor"": ""#5F5F5F""," + "\n" +
@"        ""buttonColor"": ""#4A4A4A""," + "\n" +
@"        ""buttonTextColor"": ""#FFFFFF""," + "\n" +
@"        ""name"": ""Custom Slate v2""," + "\n" +
@"        ""footer"": ""<p>Copyright © 2025 My Company</p>""," + "\n" +
@"        ""backgroundOutlineColor"": ""#4A4A4A""," + "\n" +
@"        ""foregroundMainColor"": ""#4A4A4A""," + "\n" +
@"        ""foregroundHighlightColor"": ""#4A4A4A""," + "\n" +
@"        ""schemaVersion"": 2," + "\n" +
@"        ""buttonBorderColor"": ""#4A4A4A""," + "\n" +
@"        ""focusRectangleColor"": ""#D033FF""," + "\n" +
@"        ""buttonHoverStateFillColor"": ""#4A4A4A""," + "\n" +
@"        ""buttonHoverStateBorderColor"": ""#4A4A4A""," + "\n" +
@"        ""buttonHoverStateTextColor"": ""#FFFFFF""," + "\n" +
@"        ""subTitleTextColor"": ""#4A4A4A""," + "\n" +
@"        ""titleTextColor"": ""#4A4A4A""," + "\n" +
@"        ""linkTextHoverColor"": ""#007CBA""," + "\n" +
@"        ""inputLabelTextColor"": ""#798087""," + "\n" +
@"        ""inputBoxBorderColor"": ""#4A4A4A""," + "\n" +
@"        ""cardBorderColor"": ""#CACED3""," + "\n" +
@"        ""globalFont"": ""\""Helvetica Neue\"", Helvetica, sans-serif""," + "\n" +
@"        ""logoHeight"": ""56px""," + "\n" +
@"        ""buttonBorderWidth"": ""1px""," + "\n" +
@"        ""buttonCornerRadius"": ""2px""," + "\n" +
@"        ""buttonTextSize"": ""18px""," + "\n" +
@"        ""buttonTextWeight"": ""400""," + "\n" +
@"        ""titleTextSize"": ""20px""," + "\n" +
@"        ""titleTextWeight"": ""600""," + "\n" +
@"        ""subTitleTextSize"": ""15px""," + "\n" +
@"        ""subTitleTextWeight"": ""400""," + "\n" +
@"        ""bodyTextSize"": ""15px""," + "\n" +
@"        ""bodyTextWeight"": ""400""," + "\n" +
@"        ""linkTextSize"": ""15px""," + "\n" +
@"        ""linkTextWeight"": ""400""," + "\n" +
@"        ""inputLabelTextSize"": ""15px""," + "\n" +
@"        ""inputLabelTextWeight"": ""600""," + "\n" +
@"        ""inputValueTextSize"": ""15px""," + "\n" +
@"        ""inputValueTextWeight"": ""600""," + "\n" +
@"        ""inputValueTextColor"": ""#798087""," + "\n" +
@"        ""inputBorderWidth"": ""1px""," + "\n" +
@"        ""inputCornerRadius"": ""0px""," + "\n" +
@"        ""inputLabelPosition"": ""float""," + "\n" +
@"        ""cardBorderWidth"": ""0px""," + "\n" +
@"        ""cardCornerRadius"": ""0px""," + "\n" +
@"        ""cardShadow"": ""0px""," + "\n" +
@"        ""cardHorizontalAlignment"": ""left""," + "\n" +
@"        ""cardVerticalAlignment"": ""center""," + "\n" +
@"        ""footerLocalized"": {" + "\n" +
@"            ""enabled"": true," + "\n" +
@"            ""defaultLanguage"": ""en""," + "\n" +
@"            ""contentType"": ""HTML""," + "\n" +
@"            ""content"": {" + "\n" +
@"                ""en"": {" + "\n" +
@"                    ""inputText"": ""<p>Copyright © 2025 My Company</p>""" + "\n" +
@"                }" + "\n" +
@"            }" + "\n" +
@"        }," + "\n" +
@"        ""cardLogoAlignment"": ""left""" + "\n" +
@"    }" + "\n" +
@"}";
request.AddStringBody(body, DataFormat.Json);
RestResponse response = await client.ExecuteAsync(request);
Console.WriteLine(response.Content);
package main

import (
  "fmt"
  "strings"
  "net/http"
  "io"
)

func main() {

  url := "{{apiPath}}/environments/{{envID}}/themes"
  method := "POST"

  payload := strings.NewReader(`{
    "template": "slate",
    "default": false,
    "configuration": {
        "logoType": "IMAGE",
        "logo": {
            "href": "https://d3uinntk0mqu3p.cloudfront.net/branding/market/a3d073bc-3108-49ad-b96c-404bea59a1d0.png",
            "id": "00000000-0000-0000-0000-000000000000"
        },
        "applicationBackgroundColor": "#f8f8f8",
        "backgroundType": "DEFAULT",
        "bodyTextColor": "#4C4C4C",
        "cardColor": "#FFFFFF",
        "headingTextColor": "#4A4A4A",
        "linkTextColor": "#5F5F5F",
        "buttonColor": "#4A4A4A",
        "buttonTextColor": "#FFFFFF",
        "name": "Custom Slate v2",
        "footer": "<p>Copyright © 2025 My Company</p>",
        "backgroundOutlineColor": "#4A4A4A",
        "foregroundMainColor": "#4A4A4A",
        "foregroundHighlightColor": "#4A4A4A",
        "schemaVersion": 2,
        "buttonBorderColor": "#4A4A4A",
        "focusRectangleColor": "#D033FF",
        "buttonHoverStateFillColor": "#4A4A4A",
        "buttonHoverStateBorderColor": "#4A4A4A",
        "buttonHoverStateTextColor": "#FFFFFF",
        "subTitleTextColor": "#4A4A4A",
        "titleTextColor": "#4A4A4A",
        "linkTextHoverColor": "#007CBA",
        "inputLabelTextColor": "#798087",
        "inputBoxBorderColor": "#4A4A4A",
        "cardBorderColor": "#CACED3",
        "globalFont": "\"Helvetica Neue\", Helvetica, sans-serif",
        "logoHeight": "56px",
        "buttonBorderWidth": "1px",
        "buttonCornerRadius": "2px",
        "buttonTextSize": "18px",
        "buttonTextWeight": "400",
        "titleTextSize": "20px",
        "titleTextWeight": "600",
        "subTitleTextSize": "15px",
        "subTitleTextWeight": "400",
        "bodyTextSize": "15px",
        "bodyTextWeight": "400",
        "linkTextSize": "15px",
        "linkTextWeight": "400",
        "inputLabelTextSize": "15px",
        "inputLabelTextWeight": "600",
        "inputValueTextSize": "15px",
        "inputValueTextWeight": "600",
        "inputValueTextColor": "#798087",
        "inputBorderWidth": "1px",
        "inputCornerRadius": "0px",
        "inputLabelPosition": "float",
        "cardBorderWidth": "0px",
        "cardCornerRadius": "0px",
        "cardShadow": "0px",
        "cardHorizontalAlignment": "left",
        "cardVerticalAlignment": "center",
        "footerLocalized": {
            "enabled": true,
            "defaultLanguage": "en",
            "contentType": "HTML",
            "content": {
                "en": {
                    "inputText": "<p>Copyright © 2025 My Company</p>"
                }
            }
        },
        "cardLogoAlignment": "left"
    }
}`)

  client := &http.Client {
  }
  req, err := http.NewRequest(method, url, payload)

  if err != nil {
    fmt.Println(err)
    return
  }
  req.Header.Add("Content-Type", "application/json")
  req.Header.Add("Authorization", "Bearer {{accessToken}}")

  res, err := client.Do(req)
  if err != nil {
    fmt.Println(err)
    return
  }
  defer res.Body.Close()

  body, err := io.ReadAll(res.Body)
  if err != nil {
    fmt.Println(err)
    return
  }
  fmt.Println(string(body))
}
POST /environments/{{envID}}/themes HTTP/1.1
Host: {{apiPath}}
Content-Type: application/json
Authorization: Bearer {{accessToken}}

{
    "template": "slate",
    "default": false,
    "configuration": {
        "logoType": "IMAGE",
        "logo": {
            "href": "https://d3uinntk0mqu3p.cloudfront.net/branding/market/a3d073bc-3108-49ad-b96c-404bea59a1d0.png",
            "id": "00000000-0000-0000-0000-000000000000"
        },
        "applicationBackgroundColor": "#f8f8f8",
        "backgroundType": "DEFAULT",
        "bodyTextColor": "#4C4C4C",
        "cardColor": "#FFFFFF",
        "headingTextColor": "#4A4A4A",
        "linkTextColor": "#5F5F5F",
        "buttonColor": "#4A4A4A",
        "buttonTextColor": "#FFFFFF",
        "name": "Custom Slate v2",
        "footer": "<p>Copyright © 2025 My Company</p>",
        "backgroundOutlineColor": "#4A4A4A",
        "foregroundMainColor": "#4A4A4A",
        "foregroundHighlightColor": "#4A4A4A",
        "schemaVersion": 2,
        "buttonBorderColor": "#4A4A4A",
        "focusRectangleColor": "#D033FF",
        "buttonHoverStateFillColor": "#4A4A4A",
        "buttonHoverStateBorderColor": "#4A4A4A",
        "buttonHoverStateTextColor": "#FFFFFF",
        "subTitleTextColor": "#4A4A4A",
        "titleTextColor": "#4A4A4A",
        "linkTextHoverColor": "#007CBA",
        "inputLabelTextColor": "#798087",
        "inputBoxBorderColor": "#4A4A4A",
        "cardBorderColor": "#CACED3",
        "globalFont": "\"Helvetica Neue\", Helvetica, sans-serif",
        "logoHeight": "56px",
        "buttonBorderWidth": "1px",
        "buttonCornerRadius": "2px",
        "buttonTextSize": "18px",
        "buttonTextWeight": "400",
        "titleTextSize": "20px",
        "titleTextWeight": "600",
        "subTitleTextSize": "15px",
        "subTitleTextWeight": "400",
        "bodyTextSize": "15px",
        "bodyTextWeight": "400",
        "linkTextSize": "15px",
        "linkTextWeight": "400",
        "inputLabelTextSize": "15px",
        "inputLabelTextWeight": "600",
        "inputValueTextSize": "15px",
        "inputValueTextWeight": "600",
        "inputValueTextColor": "#798087",
        "inputBorderWidth": "1px",
        "inputCornerRadius": "0px",
        "inputLabelPosition": "float",
        "cardBorderWidth": "0px",
        "cardCornerRadius": "0px",
        "cardShadow": "0px",
        "cardHorizontalAlignment": "left",
        "cardVerticalAlignment": "center",
        "footerLocalized": {
            "enabled": true,
            "defaultLanguage": "en",
            "contentType": "HTML",
            "content": {
                "en": {
                    "inputText": "<p>Copyright © 2025 My Company</p>"
                }
            }
        },
        "cardLogoAlignment": "left"
    }
}
OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\n    \"template\": \"slate\",\n    \"default\": false,\n    \"configuration\": {\n        \"logoType\": \"IMAGE\",\n        \"logo\": {\n            \"href\": \"https://d3uinntk0mqu3p.cloudfront.net/branding/market/a3d073bc-3108-49ad-b96c-404bea59a1d0.png\",\n            \"id\": \"00000000-0000-0000-0000-000000000000\"\n        },\n        \"applicationBackgroundColor\": \"#f8f8f8\",\n        \"backgroundType\": \"DEFAULT\",\n        \"bodyTextColor\": \"#4C4C4C\",\n        \"cardColor\": \"#FFFFFF\",\n        \"headingTextColor\": \"#4A4A4A\",\n        \"linkTextColor\": \"#5F5F5F\",\n        \"buttonColor\": \"#4A4A4A\",\n        \"buttonTextColor\": \"#FFFFFF\",\n        \"name\": \"Custom Slate v2\",\n        \"footer\": \"<p>Copyright © 2025 My Company</p>\",\n        \"backgroundOutlineColor\": \"#4A4A4A\",\n        \"foregroundMainColor\": \"#4A4A4A\",\n        \"foregroundHighlightColor\": \"#4A4A4A\",\n        \"schemaVersion\": 2,\n        \"buttonBorderColor\": \"#4A4A4A\",\n        \"focusRectangleColor\": \"#D033FF\",\n        \"buttonHoverStateFillColor\": \"#4A4A4A\",\n        \"buttonHoverStateBorderColor\": \"#4A4A4A\",\n        \"buttonHoverStateTextColor\": \"#FFFFFF\",\n        \"subTitleTextColor\": \"#4A4A4A\",\n        \"titleTextColor\": \"#4A4A4A\",\n        \"linkTextHoverColor\": \"#007CBA\",\n        \"inputLabelTextColor\": \"#798087\",\n        \"inputBoxBorderColor\": \"#4A4A4A\",\n        \"cardBorderColor\": \"#CACED3\",\n        \"globalFont\": \"\\\"Helvetica Neue\\\", Helvetica, sans-serif\",\n        \"logoHeight\": \"56px\",\n        \"buttonBorderWidth\": \"1px\",\n        \"buttonCornerRadius\": \"2px\",\n        \"buttonTextSize\": \"18px\",\n        \"buttonTextWeight\": \"400\",\n        \"titleTextSize\": \"20px\",\n        \"titleTextWeight\": \"600\",\n        \"subTitleTextSize\": \"15px\",\n        \"subTitleTextWeight\": \"400\",\n        \"bodyTextSize\": \"15px\",\n        \"bodyTextWeight\": \"400\",\n        \"linkTextSize\": \"15px\",\n        \"linkTextWeight\": \"400\",\n        \"inputLabelTextSize\": \"15px\",\n        \"inputLabelTextWeight\": \"600\",\n        \"inputValueTextSize\": \"15px\",\n        \"inputValueTextWeight\": \"600\",\n        \"inputValueTextColor\": \"#798087\",\n        \"inputBorderWidth\": \"1px\",\n        \"inputCornerRadius\": \"0px\",\n        \"inputLabelPosition\": \"float\",\n        \"cardBorderWidth\": \"0px\",\n        \"cardCornerRadius\": \"0px\",\n        \"cardShadow\": \"0px\",\n        \"cardHorizontalAlignment\": \"left\",\n        \"cardVerticalAlignment\": \"center\",\n        \"footerLocalized\": {\n            \"enabled\": true,\n            \"defaultLanguage\": \"en\",\n            \"contentType\": \"HTML\",\n            \"content\": {\n                \"en\": {\n                    \"inputText\": \"<p>Copyright © 2025 My Company</p>\"\n                }\n            }\n        },\n        \"cardLogoAlignment\": \"left\"\n    }\n}");
Request request = new Request.Builder()
  .url("{{apiPath}}/environments/{{envID}}/themes")
  .method("POST", body)
  .addHeader("Content-Type", "application/json")
  .addHeader("Authorization", "Bearer {{accessToken}}")
  .build();
Response response = client.newCall(request).execute();
var settings = {
  "url": "{{apiPath}}/environments/{{envID}}/themes",
  "method": "POST",
  "timeout": 0,
  "headers": {
    "Content-Type": "application/json",
    "Authorization": "Bearer {{accessToken}}"
  },
  "data": JSON.stringify({
    "template": "slate",
    "default": false,
    "configuration": {
      "logoType": "IMAGE",
      "logo": {
        "href": "https://d3uinntk0mqu3p.cloudfront.net/branding/market/a3d073bc-3108-49ad-b96c-404bea59a1d0.png",
        "id": "00000000-0000-0000-0000-000000000000"
      },
      "applicationBackgroundColor": "#f8f8f8",
      "backgroundType": "DEFAULT",
      "bodyTextColor": "#4C4C4C",
      "cardColor": "#FFFFFF",
      "headingTextColor": "#4A4A4A",
      "linkTextColor": "#5F5F5F",
      "buttonColor": "#4A4A4A",
      "buttonTextColor": "#FFFFFF",
      "name": "Custom Slate v2",
      "footer": "<p>Copyright © 2025 My Company</p>",
      "backgroundOutlineColor": "#4A4A4A",
      "foregroundMainColor": "#4A4A4A",
      "foregroundHighlightColor": "#4A4A4A",
      "schemaVersion": 2,
      "buttonBorderColor": "#4A4A4A",
      "focusRectangleColor": "#D033FF",
      "buttonHoverStateFillColor": "#4A4A4A",
      "buttonHoverStateBorderColor": "#4A4A4A",
      "buttonHoverStateTextColor": "#FFFFFF",
      "subTitleTextColor": "#4A4A4A",
      "titleTextColor": "#4A4A4A",
      "linkTextHoverColor": "#007CBA",
      "inputLabelTextColor": "#798087",
      "inputBoxBorderColor": "#4A4A4A",
      "cardBorderColor": "#CACED3",
      "globalFont": "\"Helvetica Neue\", Helvetica, sans-serif",
      "logoHeight": "56px",
      "buttonBorderWidth": "1px",
      "buttonCornerRadius": "2px",
      "buttonTextSize": "18px",
      "buttonTextWeight": "400",
      "titleTextSize": "20px",
      "titleTextWeight": "600",
      "subTitleTextSize": "15px",
      "subTitleTextWeight": "400",
      "bodyTextSize": "15px",
      "bodyTextWeight": "400",
      "linkTextSize": "15px",
      "linkTextWeight": "400",
      "inputLabelTextSize": "15px",
      "inputLabelTextWeight": "600",
      "inputValueTextSize": "15px",
      "inputValueTextWeight": "600",
      "inputValueTextColor": "#798087",
      "inputBorderWidth": "1px",
      "inputCornerRadius": "0px",
      "inputLabelPosition": "float",
      "cardBorderWidth": "0px",
      "cardCornerRadius": "0px",
      "cardShadow": "0px",
      "cardHorizontalAlignment": "left",
      "cardVerticalAlignment": "center",
      "footerLocalized": {
        "enabled": true,
        "defaultLanguage": "en",
        "contentType": "HTML",
        "content": {
          "en": {
            "inputText": "<p>Copyright © 2025 My Company</p>"
          }
        }
      },
      "cardLogoAlignment": "left"
    }
  }),
};

$.ajax(settings).done(function (response) {
  console.log(response);
});
var request = require('request');
var options = {
  'method': 'POST',
  'url': '{{apiPath}}/environments/{{envID}}/themes',
  'headers': {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer {{accessToken}}'
  },
  body: JSON.stringify({
    "template": "slate",
    "default": false,
    "configuration": {
      "logoType": "IMAGE",
      "logo": {
        "href": "https://d3uinntk0mqu3p.cloudfront.net/branding/market/a3d073bc-3108-49ad-b96c-404bea59a1d0.png",
        "id": "00000000-0000-0000-0000-000000000000"
      },
      "applicationBackgroundColor": "#f8f8f8",
      "backgroundType": "DEFAULT",
      "bodyTextColor": "#4C4C4C",
      "cardColor": "#FFFFFF",
      "headingTextColor": "#4A4A4A",
      "linkTextColor": "#5F5F5F",
      "buttonColor": "#4A4A4A",
      "buttonTextColor": "#FFFFFF",
      "name": "Custom Slate v2",
      "footer": "<p>Copyright © 2025 My Company</p>",
      "backgroundOutlineColor": "#4A4A4A",
      "foregroundMainColor": "#4A4A4A",
      "foregroundHighlightColor": "#4A4A4A",
      "schemaVersion": 2,
      "buttonBorderColor": "#4A4A4A",
      "focusRectangleColor": "#D033FF",
      "buttonHoverStateFillColor": "#4A4A4A",
      "buttonHoverStateBorderColor": "#4A4A4A",
      "buttonHoverStateTextColor": "#FFFFFF",
      "subTitleTextColor": "#4A4A4A",
      "titleTextColor": "#4A4A4A",
      "linkTextHoverColor": "#007CBA",
      "inputLabelTextColor": "#798087",
      "inputBoxBorderColor": "#4A4A4A",
      "cardBorderColor": "#CACED3",
      "globalFont": "\"Helvetica Neue\", Helvetica, sans-serif",
      "logoHeight": "56px",
      "buttonBorderWidth": "1px",
      "buttonCornerRadius": "2px",
      "buttonTextSize": "18px",
      "buttonTextWeight": "400",
      "titleTextSize": "20px",
      "titleTextWeight": "600",
      "subTitleTextSize": "15px",
      "subTitleTextWeight": "400",
      "bodyTextSize": "15px",
      "bodyTextWeight": "400",
      "linkTextSize": "15px",
      "linkTextWeight": "400",
      "inputLabelTextSize": "15px",
      "inputLabelTextWeight": "600",
      "inputValueTextSize": "15px",
      "inputValueTextWeight": "600",
      "inputValueTextColor": "#798087",
      "inputBorderWidth": "1px",
      "inputCornerRadius": "0px",
      "inputLabelPosition": "float",
      "cardBorderWidth": "0px",
      "cardCornerRadius": "0px",
      "cardShadow": "0px",
      "cardHorizontalAlignment": "left",
      "cardVerticalAlignment": "center",
      "footerLocalized": {
        "enabled": true,
        "defaultLanguage": "en",
        "contentType": "HTML",
        "content": {
          "en": {
            "inputText": "<p>Copyright © 2025 My Company</p>"
          }
        }
      },
      "cardLogoAlignment": "left"
    }
  })

};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});
import requests
import json

url = "{{apiPath}}/environments/{{envID}}/themes"

payload = json.dumps({
  "template": "slate",
  "default": False,
  "configuration": {
    "logoType": "IMAGE",
    "logo": {
      "href": "https://d3uinntk0mqu3p.cloudfront.net/branding/market/a3d073bc-3108-49ad-b96c-404bea59a1d0.png",
      "id": "00000000-0000-0000-0000-000000000000"
    },
    "applicationBackgroundColor": "#f8f8f8",
    "backgroundType": "DEFAULT",
    "bodyTextColor": "#4C4C4C",
    "cardColor": "#FFFFFF",
    "headingTextColor": "#4A4A4A",
    "linkTextColor": "#5F5F5F",
    "buttonColor": "#4A4A4A",
    "buttonTextColor": "#FFFFFF",
    "name": "Custom Slate v2",
    "footer": "<p>Copyright © 2025 My Company</p>",
    "backgroundOutlineColor": "#4A4A4A",
    "foregroundMainColor": "#4A4A4A",
    "foregroundHighlightColor": "#4A4A4A",
    "schemaVersion": 2,
    "buttonBorderColor": "#4A4A4A",
    "focusRectangleColor": "#D033FF",
    "buttonHoverStateFillColor": "#4A4A4A",
    "buttonHoverStateBorderColor": "#4A4A4A",
    "buttonHoverStateTextColor": "#FFFFFF",
    "subTitleTextColor": "#4A4A4A",
    "titleTextColor": "#4A4A4A",
    "linkTextHoverColor": "#007CBA",
    "inputLabelTextColor": "#798087",
    "inputBoxBorderColor": "#4A4A4A",
    "cardBorderColor": "#CACED3",
    "globalFont": "\"Helvetica Neue\", Helvetica, sans-serif",
    "logoHeight": "56px",
    "buttonBorderWidth": "1px",
    "buttonCornerRadius": "2px",
    "buttonTextSize": "18px",
    "buttonTextWeight": "400",
    "titleTextSize": "20px",
    "titleTextWeight": "600",
    "subTitleTextSize": "15px",
    "subTitleTextWeight": "400",
    "bodyTextSize": "15px",
    "bodyTextWeight": "400",
    "linkTextSize": "15px",
    "linkTextWeight": "400",
    "inputLabelTextSize": "15px",
    "inputLabelTextWeight": "600",
    "inputValueTextSize": "15px",
    "inputValueTextWeight": "600",
    "inputValueTextColor": "#798087",
    "inputBorderWidth": "1px",
    "inputCornerRadius": "0px",
    "inputLabelPosition": "float",
    "cardBorderWidth": "0px",
    "cardCornerRadius": "0px",
    "cardShadow": "0px",
    "cardHorizontalAlignment": "left",
    "cardVerticalAlignment": "center",
    "footerLocalized": {
      "enabled": True,
      "defaultLanguage": "en",
      "contentType": "HTML",
      "content": {
        "en": {
          "inputText": "<p>Copyright © 2025 My Company</p>"
        }
      }
    },
    "cardLogoAlignment": "left"
  }
})
headers = {
  'Content-Type': 'application/json',
  'Authorization': 'Bearer {{accessToken}}'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)
<?php
require_once 'HTTP/Request2.php';
$request = new HTTP_Request2();
$request->setUrl('{{apiPath}}/environments/{{envID}}/themes');
$request->setMethod(HTTP_Request2::METHOD_POST);
$request->setConfig(array(
  'follow_redirects' => TRUE
));
$request->setHeader(array(
  'Content-Type' => 'application/json',
  'Authorization' => 'Bearer {{accessToken}}'
));
$request->setBody('{\n    "template": "slate",\n    "default": false,\n    "configuration": {\n        "logoType": "IMAGE",\n        "logo": {\n            "href": "https://d3uinntk0mqu3p.cloudfront.net/branding/market/a3d073bc-3108-49ad-b96c-404bea59a1d0.png",\n            "id": "00000000-0000-0000-0000-000000000000"\n        },\n        "applicationBackgroundColor": "#f8f8f8",\n        "backgroundType": "DEFAULT",\n        "bodyTextColor": "#4C4C4C",\n        "cardColor": "#FFFFFF",\n        "headingTextColor": "#4A4A4A",\n        "linkTextColor": "#5F5F5F",\n        "buttonColor": "#4A4A4A",\n        "buttonTextColor": "#FFFFFF",\n        "name": "Custom Slate v2",\n        "footer": "<p>Copyright © 2025 My Company</p>",\n        "backgroundOutlineColor": "#4A4A4A",\n        "foregroundMainColor": "#4A4A4A",\n        "foregroundHighlightColor": "#4A4A4A",\n        "schemaVersion": 2,\n        "buttonBorderColor": "#4A4A4A",\n        "focusRectangleColor": "#D033FF",\n        "buttonHoverStateFillColor": "#4A4A4A",\n        "buttonHoverStateBorderColor": "#4A4A4A",\n        "buttonHoverStateTextColor": "#FFFFFF",\n        "subTitleTextColor": "#4A4A4A",\n        "titleTextColor": "#4A4A4A",\n        "linkTextHoverColor": "#007CBA",\n        "inputLabelTextColor": "#798087",\n        "inputBoxBorderColor": "#4A4A4A",\n        "cardBorderColor": "#CACED3",\n        "globalFont": "\\"Helvetica Neue\\", Helvetica, sans-serif",\n        "logoHeight": "56px",\n        "buttonBorderWidth": "1px",\n        "buttonCornerRadius": "2px",\n        "buttonTextSize": "18px",\n        "buttonTextWeight": "400",\n        "titleTextSize": "20px",\n        "titleTextWeight": "600",\n        "subTitleTextSize": "15px",\n        "subTitleTextWeight": "400",\n        "bodyTextSize": "15px",\n        "bodyTextWeight": "400",\n        "linkTextSize": "15px",\n        "linkTextWeight": "400",\n        "inputLabelTextSize": "15px",\n        "inputLabelTextWeight": "600",\n        "inputValueTextSize": "15px",\n        "inputValueTextWeight": "600",\n        "inputValueTextColor": "#798087",\n        "inputBorderWidth": "1px",\n        "inputCornerRadius": "0px",\n        "inputLabelPosition": "float",\n        "cardBorderWidth": "0px",\n        "cardCornerRadius": "0px",\n        "cardShadow": "0px",\n        "cardHorizontalAlignment": "left",\n        "cardVerticalAlignment": "center",\n        "footerLocalized": {\n            "enabled": true,\n            "defaultLanguage": "en",\n            "contentType": "HTML",\n            "content": {\n                "en": {\n                    "inputText": "<p>Copyright © 2025 My Company</p>"\n                }\n            }\n        },\n        "cardLogoAlignment": "left"\n    }\n}');
try {
  $response = $request->send();
  if ($response->getStatus() == 200) {
    echo $response->getBody();
  }
  else {
    echo 'Unexpected HTTP status: ' . $response->getStatus() . ' ' .
    $response->getReasonPhrase();
  }
}
catch(HTTP_Request2_Exception $e) {
  echo 'Error: ' . $e->getMessage();
}
require "uri"
require "json"
require "net/http"

url = URI("{{apiPath}}/environments/{{envID}}/themes")

http = Net::HTTP.new(url.host, url.port);
request = Net::HTTP::Post.new(url)
request["Content-Type"] = "application/json"
request["Authorization"] = "Bearer {{accessToken}}"
request.body = JSON.dump({
  "template": "slate",
  "default": false,
  "configuration": {
    "logoType": "IMAGE",
    "logo": {
      "href": "https://d3uinntk0mqu3p.cloudfront.net/branding/market/a3d073bc-3108-49ad-b96c-404bea59a1d0.png",
      "id": "00000000-0000-0000-0000-000000000000"
    },
    "applicationBackgroundColor": "\#f8f8f8",
    "backgroundType": "DEFAULT",
    "bodyTextColor": "\#4C4C4C",
    "cardColor": "\#FFFFFF",
    "headingTextColor": "\#4A4A4A",
    "linkTextColor": "\#5F5F5F",
    "buttonColor": "\#4A4A4A",
    "buttonTextColor": "\#FFFFFF",
    "name": "Custom Slate v2",
    "footer": "<p>Copyright © 2025 My Company</p>",
    "backgroundOutlineColor": "\#4A4A4A",
    "foregroundMainColor": "\#4A4A4A",
    "foregroundHighlightColor": "\#4A4A4A",
    "schemaVersion": 2,
    "buttonBorderColor": "\#4A4A4A",
    "focusRectangleColor": "\#D033FF",
    "buttonHoverStateFillColor": "\#4A4A4A",
    "buttonHoverStateBorderColor": "\#4A4A4A",
    "buttonHoverStateTextColor": "\#FFFFFF",
    "subTitleTextColor": "\#4A4A4A",
    "titleTextColor": "\#4A4A4A",
    "linkTextHoverColor": "\#007CBA",
    "inputLabelTextColor": "\#798087",
    "inputBoxBorderColor": "\#4A4A4A",
    "cardBorderColor": "\#CACED3",
    "globalFont": "\"Helvetica Neue\", Helvetica, sans-serif",
    "logoHeight": "56px",
    "buttonBorderWidth": "1px",
    "buttonCornerRadius": "2px",
    "buttonTextSize": "18px",
    "buttonTextWeight": "400",
    "titleTextSize": "20px",
    "titleTextWeight": "600",
    "subTitleTextSize": "15px",
    "subTitleTextWeight": "400",
    "bodyTextSize": "15px",
    "bodyTextWeight": "400",
    "linkTextSize": "15px",
    "linkTextWeight": "400",
    "inputLabelTextSize": "15px",
    "inputLabelTextWeight": "600",
    "inputValueTextSize": "15px",
    "inputValueTextWeight": "600",
    "inputValueTextColor": "\#798087",
    "inputBorderWidth": "1px",
    "inputCornerRadius": "0px",
    "inputLabelPosition": "float",
    "cardBorderWidth": "0px",
    "cardCornerRadius": "0px",
    "cardShadow": "0px",
    "cardHorizontalAlignment": "left",
    "cardVerticalAlignment": "center",
    "footerLocalized": {
      "enabled": true,
      "defaultLanguage": "en",
      "contentType": "HTML",
      "content": {
        "en": {
          "inputText": "<p>Copyright © 2025 My Company</p>"
        }
      }
    },
    "cardLogoAlignment": "left"
  }
})

response = http.request(request)
puts response.read_body
let parameters = "{\n    \"template\": \"slate\",\n    \"default\": false,\n    \"configuration\": {\n        \"logoType\": \"IMAGE\",\n        \"logo\": {\n            \"href\": \"https://d3uinntk0mqu3p.cloudfront.net/branding/market/a3d073bc-3108-49ad-b96c-404bea59a1d0.png\",\n            \"id\": \"00000000-0000-0000-0000-000000000000\"\n        },\n        \"applicationBackgroundColor\": \"#f8f8f8\",\n        \"backgroundType\": \"DEFAULT\",\n        \"bodyTextColor\": \"#4C4C4C\",\n        \"cardColor\": \"#FFFFFF\",\n        \"headingTextColor\": \"#4A4A4A\",\n        \"linkTextColor\": \"#5F5F5F\",\n        \"buttonColor\": \"#4A4A4A\",\n        \"buttonTextColor\": \"#FFFFFF\",\n        \"name\": \"Custom Slate v2\",\n        \"footer\": \"<p>Copyright © 2025 My Company</p>\",\n        \"backgroundOutlineColor\": \"#4A4A4A\",\n        \"foregroundMainColor\": \"#4A4A4A\",\n        \"foregroundHighlightColor\": \"#4A4A4A\",\n        \"schemaVersion\": 2,\n        \"buttonBorderColor\": \"#4A4A4A\",\n        \"focusRectangleColor\": \"#D033FF\",\n        \"buttonHoverStateFillColor\": \"#4A4A4A\",\n        \"buttonHoverStateBorderColor\": \"#4A4A4A\",\n        \"buttonHoverStateTextColor\": \"#FFFFFF\",\n        \"subTitleTextColor\": \"#4A4A4A\",\n        \"titleTextColor\": \"#4A4A4A\",\n        \"linkTextHoverColor\": \"#007CBA\",\n        \"inputLabelTextColor\": \"#798087\",\n        \"inputBoxBorderColor\": \"#4A4A4A\",\n        \"cardBorderColor\": \"#CACED3\",\n        \"globalFont\": \"\\\"Helvetica Neue\\\", Helvetica, sans-serif\",\n        \"logoHeight\": \"56px\",\n        \"buttonBorderWidth\": \"1px\",\n        \"buttonCornerRadius\": \"2px\",\n        \"buttonTextSize\": \"18px\",\n        \"buttonTextWeight\": \"400\",\n        \"titleTextSize\": \"20px\",\n        \"titleTextWeight\": \"600\",\n        \"subTitleTextSize\": \"15px\",\n        \"subTitleTextWeight\": \"400\",\n        \"bodyTextSize\": \"15px\",\n        \"bodyTextWeight\": \"400\",\n        \"linkTextSize\": \"15px\",\n        \"linkTextWeight\": \"400\",\n        \"inputLabelTextSize\": \"15px\",\n        \"inputLabelTextWeight\": \"600\",\n        \"inputValueTextSize\": \"15px\",\n        \"inputValueTextWeight\": \"600\",\n        \"inputValueTextColor\": \"#798087\",\n        \"inputBorderWidth\": \"1px\",\n        \"inputCornerRadius\": \"0px\",\n        \"inputLabelPosition\": \"float\",\n        \"cardBorderWidth\": \"0px\",\n        \"cardCornerRadius\": \"0px\",\n        \"cardShadow\": \"0px\",\n        \"cardHorizontalAlignment\": \"left\",\n        \"cardVerticalAlignment\": \"center\",\n        \"footerLocalized\": {\n            \"enabled\": true,\n            \"defaultLanguage\": \"en\",\n            \"contentType\": \"HTML\",\n            \"content\": {\n                \"en\": {\n                    \"inputText\": \"<p>Copyright © 2025 My Company</p>\"\n                }\n            }\n        },\n        \"cardLogoAlignment\": \"left\"\n    }\n}"
let postData = parameters.data(using: .utf8)

var request = URLRequest(url: URL(string: "{{apiPath}}/environments/{{envID}}/themes")!,timeoutInterval: Double.infinity)
request.addValue("application/json", forHTTPHeaderField: "Content-Type")
request.addValue("Bearer {{accessToken}}", forHTTPHeaderField: "Authorization")

request.httpMethod = "POST"
request.httpBody = postData

let task = URLSession.shared.dataTask(with: request) { data, response, error in
  guard let data = data else {
    print(String(describing: error))
    return
  }
  print(String(data: data, encoding: .utf8)!)
}

task.resume()

Example Response

200 OK

{
    "_links": {
        "self": {
            "href": "https://api.pingone.com/v1/environments/abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6/themes/9d2623ff-6021-4323-b27c-3affc5385a29"
        },
        "environment": {
            "href": "https://api.pingone.com/v1/environments/abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6"
        }
    },
    "environment": {
        "id": "abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6"
    },
    "id": "9d2623ff-6021-4323-b27c-3affc5385a29",
    "template": "slate",
    "default": false,
    "configuration": {
        "logoType": "IMAGE",
        "logo": {
            "href": "https://d3uinntk0mqu3p.cloudfront.net/branding/market/a3d073bc-3108-49ad-b96c-404bea59a1d0.png",
            "id": "00000000-0000-0000-0000-000000000000"
        },
        "applicationBackgroundColor": "#f8f8f8",
        "backgroundType": "DEFAULT",
        "bodyTextColor": "#4C4C4C",
        "cardColor": "#FFFFFF",
        "headingTextColor": "#4A4A4A",
        "linkTextColor": "#5F5F5F",
        "buttonColor": "#4A4A4A",
        "buttonTextColor": "#FFFFFF",
        "name": "Custom Slate v2",
        "footer": "<p>Copyright © 2025 My Company</p>",
        "backgroundOutlineColor": "#4A4A4A",
        "foregroundMainColor": "#4A4A4A",
        "foregroundHighlightColor": "#4A4A4A",
        "schemaVersion": 2,
        "buttonBorderColor": "#4A4A4A",
        "focusRectangleColor": "#D033FF",
        "buttonHoverStateFillColor": "#4A4A4A",
        "buttonHoverStateBorderColor": "#4A4A4A",
        "buttonHoverStateTextColor": "#FFFFFF",
        "subTitleTextColor": "#4A4A4A",
        "titleTextColor": "#4A4A4A",
        "linkTextHoverColor": "#007CBA",
        "inputLabelTextColor": "#798087",
        "inputBoxBorderColor": "#4A4A4A",
        "cardBorderColor": "#CACED3",
        "globalFont": "\"Helvetica Neue\", Helvetica, sans-serif",
        "logoHeight": "56px",
        "buttonBorderWidth": "1px",
        "buttonCornerRadius": "2px",
        "buttonTextSize": "18px",
        "buttonTextWeight": "400",
        "titleTextSize": "20px",
        "titleTextWeight": "600",
        "subTitleTextSize": "15px",
        "subTitleTextWeight": "400",
        "bodyTextSize": "15px",
        "bodyTextWeight": "400",
        "linkTextSize": "15px",
        "linkTextWeight": "400",
        "inputLabelTextSize": "15px",
        "inputLabelTextWeight": "600",
        "inputValueTextSize": "15px",
        "inputValueTextWeight": "600",
        "inputValueTextColor": "#798087",
        "inputBorderWidth": "1px",
        "inputCornerRadius": "0px",
        "inputLabelPosition": "float",
        "cardBorderWidth": "0px",
        "cardCornerRadius": "0px",
        "cardShadow": "0px",
        "cardHorizontalAlignment": "left",
        "cardVerticalAlignment": "center",
        "footerLocalized": {
            "enabled": true,
            "defaultLanguage": "en",
            "contentType": "HTML",
            "content": {
                "en": {
                    "inputText": "<p>Copyright © 2025 My Company</p>"
                }
            }
        },
        "cardLogoAlignment": "left"
    },
    "modified": "2025-11-13T17:28:04.802Z"
}