POST Request to Set Up a New Certificate
The format of the URL is:
https://<accountID>.restlets.api.netsuite.com/services/rest/auth/oauth2/v1/clients/<ClientID>/certificates
where <accountID> represents your NetSuite account ID, and <ClientID> represents the ID associated with the integration record you want to work with.
|
Request Parameter |
Description |
|---|---|
|
fileContent |
The value of the parameter is the certificate you want to set up. |
|
role |
The value of the parameter is the ID of the role for which you want to activate the certificate. |
|
entity |
The value of the parameter is the ID of the entity for which you want to activate the certificate. |
See the following example of the POST request, and the response:
Parameters:
{"fileContent": "-----BEGIN CERTIFICATE-----\nMIICMzCCAdmgAwIBAgIUBiVEnfUN+N/+Dx5y95vec4/l9cowCgYIKoZIzj0EAwIw\nbzELMAkGA1UEBhMCQ1oxEDAOBgNVBAgMB0N6ZWNoaWExDTALBgNVBAcMBEJybm8x\nGDAWBgNVBAoMD09yYWNsZSBOZXRTdWl0ZTElMCMGA1UEAwwcaW5mcmEudGVzdC5j\nb3JwLm5ldHN1aXRlLmNvbTAeFw0yNjAxMzAxMDI4MzhaFw0yNjAzMDExMDI4Mzha\nMG8xCzAJBgNVBAYTAkNaMRAwDgYDVQQIDAdDemVjaGlhMQ0wCwYDVQQHDARCcm5v\nMRgwFgYDVQQKDA9PcmFjbGUgTmV0U3VpdGUxJTAjBgNVBAMMHGluZnJhLnRlc3Qu\nY29ycC5uZXRzdWl0ZS5jb20wWTATBgcqhkjOPQIBBggqhkjOPQMBBwNCAARJqbhJ\nQl8wlogKRlaqug3YSA2jAFlDvM7S8nbP6zj7qqc7HkLXjokn0qBAa+O5oD+yb9gX\nKmUhTjOC8OKZ+JYKo1MwUTAdBgNVHQ4EFgQU5ZEvf5+g0wXYsGDQ696fDj5esrgw\nHwYDVR0jBBgwFoAU5ZEvf5+g0wXYsGDQ696fDj5esrgwDwYDVR0TAQH/BAUwAwEB\n/zAKBggqhkjOPQQDAgNIADBFAiAPVU6JJBYmVvOdPSLgDCCv/6ePrALb0ODMrWu6\nQrChtAIhAI6OCpSZyk+LvM6YPyvc64aTfnpLD9RzfAJCqm/Iy6ZA\n-----END CERTIFICATE-----", "role": 1000, "entity": "-5"}
Request Headers:
POST /services/rest/auth/oauth2/v1/clients/751a2830e09c6f47b00e486ec192934cd0efad12fdba5f4703841bd2b67d5357/certificates?c= HTTP/2
Host: 3829855.restlets.api.netsuite.com
user-agent: integration testing page
accept: */*
authorization: Bearer eyJraWQiOiJjLjM4Mjk4NTUuMjAyNi0wMS0xOF8wMi0xOC0xNyIsInR5cCI6IkpXVCIsImFsZyI6IlJTMjU2In0.eyJzdWIiOiIzOy01IiwiYXVkIjpbIjFDNjFDRDU4LTA0NEQtNDk3QS1BQTI5LTdBM0U5QTlCQjkyNDszODI5ODU1IiwiNzUxYTI4MzBlMDljNmY0N2IwMGU0ODZlYzE5MjkzNGNkMGVmYWQxMmZkYmE1ZjQ3MDM4NDFiZDJiNjdkNTM1NyJdLCJzY29wZSI6WyJyZXN0bGV0cyIsInJlc3Rfd2Vic2VydmljZXMiXSwiaXNzIjoiaHR0cHM6Ly9zeXN0ZW0ubmV0c3VpdGUuY29tIiwib2l0IjoxNzY5NzY4ODk0LCJleHAiOjE3Njk3NzI0OTQsImlhdCI6MTc2OTc2ODg5NCwianRpIjoiMzgyOTg1NS5hLWEuMWE1YWM5ZWUtZDhjNy00ZWUxLTgzMWQtOTI4Y2I1NDNkMDg1XzE3Njk3Njg4OTQyNzIuMTc2OTc2ODg5NDI3MiJ9.03MUHsRCM2iLf6yykcmnDMfDMkEFHNfjMKUFrGb1TJ1vQ-FY3C5_EemFZssvrVYujKjr87P89JUs_6Ec4tQZClvgSgNFo08qjXdbmtk8zjwRR8yrhd1oNhib8d3vJtMGjRMunlg9bVQv-CwfJAD0xBDoPC3ssvV3zSsPD_xuLcTjAXLLBPuSAKIeZNi86TjlkIcDOTx5gqzP1dERbyJCcZ9PZqLeK9vR1sJ0OHP5p8d3BbG0i6yRZPlxo97_3wi1seof3PkWYlDRlJ5q-4mv6pw3AZU82KBbg-Aa4hqhUJ5Yh-xpCvRt59gh0Zd6BJuY34gZRC6hCL4cv_mRriL7lDJk4q8TgErHO644NWfNywGgY-1QuMFwIXUD7_kQZ1R9B6NZY2lRJRGoblBy2w3Ghk6JVcb4k2OIx8chLj-ix8CYv0STWYA5LutC4r8twyX3LnSMJXeMK26NHCT6kJShxByRrQH_Ggc5qRjKr1CLixKrDXy7eGLASuQ0_CEva33xklwBRkRjbKNYUXl4z46uj9TK1oUeUM9PXL0MiPrYMkwfvuXWLe9UHIH0MQ8icJpWaMXUGNGq4qOdUaCAZWx7N01dvZIuIyYTzbZ7EL8OtiZjCh-p4a4WICZkUfIzyAZ-2v-g_RUr9MelUCU_6mTwnKMEnU7wzxXo1-kt_-XRD5k
content-type: application/json
content-length: 883
Response:
{"entity_role_id":{"com":"3829855","ent":-5,"rol":1000},"application_id":1,"certificate_id":"NPMnRyPg-WDWhPiAbisjKiH0fqnBpjOZ367wDTe0pqA","certificate":"-----BEGIN CERTIFICATE-----
MIICMzCCAdmgAwIBAgIUBiVEnfUN+N/+Dx5y95vec4/l9cowCgYIKoZIzj0EAwIw
bzELMAkGA1UEBhMCQ1oxEDAOBgNVBAgMB0N6ZWNoaWExDTALBgNVBAcMBEJybm8x
GDAWBgNVBAoMD09yYWNsZSBOZXRTdWl0ZTElMCMGA1UEAwwcaW5mcmEudGVzdC5j
b3JwLm5ldHN1aXRlLmNvbTAeFw0yNjAxMzAxMDI4MzhaFw0yNjAzMDExMDI4Mzha
MG8xCzAJBgNVBAYTAkNaMRAwDgYDVQQIDAdDemVjaGlhMQ0wCwYDVQQHDARCcm5v
MRgwFgYDVQQKDA9PcmFjbGUgTmV0U3VpdGUxJTAjBgNVBAMMHGluZnJhLnRlc3Qu
Y29ycC5uZXRzdWl0ZS5jb20wWTATBgcqhkjOPQIBBggqhkjOPQMBBwNCAARJqbhJ
Ql8wlogKRlaqug3YSA2jAFlDvM7S8nbP6zj7qqc7HkLXjokn0qBAa+O5oD+yb9gX
KmUhTjOC8OKZ+JYKo1MwUTAdBgNVHQ4EFgQU5ZEvf5+g0wXYsGDQ696fDj5esrgw
HwYDVR0jBBgwFoAU5ZEvf5+g0wXYsGDQ696fDj5esrgwDwYDVR0TAQH/BAUwAwEB
/zAKBggqhkjOPQQDAgNIADBFAiAPVU6JJBYmVvOdPSLgDCCv/6ePrALb0ODMrWu6
QrChtAIhAI6OCpSZyk+LvM6YPyvc64aTfnpLD9RzfAJCqm/Iy6ZA
-----END CERTIFICATE-----","algorithm":"EC","created_at":"2026-01-30","valid_from":"2026-01-30","valid_until":"2026-03-01","invalidated":false}
Note:
The value of the ceritificate_id parameter is used in the client assertion during the OAuth 2.0 client credentials flow.