Create Company Certificate

Create a company trusted or untrusted certificate

Create a company trusted or untrusted certificate. Different from V1 in that we reject expired certificates.

post

/v2/companycert/create

Header parameters

sessionTokenstringrequired

Session authentication token.

Body

pemstring

An X509 certificate in PEM format

Example: -----BEGIN CERTIFICATE-----MIIH/TC...p9DBiB/-----END CERTIFICATE-----

attributesobject

Responses

application/json

application/json

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'yourpodURL.symphony.com/pod/v2/companycert/create' \
  --header 'sessionToken: text' \
  --header 'Content-Type: application/json' \
  --data '{"pem":"-----BEGIN CERTIFICATE-----MIIH/TC...p9DBiB/-----END CERTIFICATE-----","attributes":{"name":"agentservice","type":{"type":"USER"},"status":{"type":"TRUSTED"}}}'

200

400

401

403

500

200

[
  {
    "companyCertInfo": {
      "fingerPrint": "450369...",
      "issuerFingerPrint": "c35680...",
      "lastSeen": 1529994790226,
      "updatedAt": 1529598066602,
      "updatedBy": 9208409884327,
      "commonName": "jiraWebHookIntegration",
      "expiryDate": 1768510565000
    },
    "companyCertAttributes": {
      "name": "jira",
      "type": {
        "type": "USER"
      },
      "status": {
        "type": "KNOWN"
      }
    },
    "certInfo": [
      {
        "name": "General",
        "attributes": [
          {
            "name": "Issuer",
            "value": "C=US O=Symphony Communications LLC CN=bot_user_provisioning"
          },
          {
            "name": "Subject",
            "value": "C=US OU=NOT FOR PRODUCTION USE O=Symphony Communications LLC CN=jiraWebHookIntegration"
          },
          {
            "name": "Signature Algorithm",
            "value": "SHA256withRSA"
          }
        ]
      },
      {
        "name": "Validity",
        "attributes": [
          {
            "name": "Not Before",
            "value": "Mon Jan 15 20:56:05 UTC 2018"
          },
          {
            "name": "Not After",
            "value": "Thu Jan 15 20:56:05 UTC 2026"
          }
        ]
      },
      {
        "name": "Public Key",
        "attributes": [
          {
            "name": "Algorithm",
            "value": "RSA"
          },
          {
            "name": "Format",
            "value": "X.509"
          }
        ]
      }
    ]
  }
]

Success

📘 Note

This v2 endpoint rejects expired certificates. When creating company certificates, make sure that you are calling the v2 version of this endpoint, and not v1.

🚧 Roles and privileges

Calling this endpoint requires the USER_PROVISIONING or the SUPER_ADMINISTRATOR role. See Bot Permissions for a list of roles and associated privileges.