Create Configuration Template
1 min
POST
https://api.upstartcommerce.com/v1/tenants/cfg/templates
acceptstringGenerated from available response content types
x-upstart-tenantstringTenant identifier associated with the site this call is for.
bodyobject<p>Request payload for creating a new configuration template. Templates define schemas for configuration records, providing type safety and validation. Use this to create reusable blueprints for integration configurations (payment gateways, shipping providers, media storage, etc.).</p>
201<p>Success-template created successfully. Returns the generated template ID.</p>
400The request contained information that the server was unable to process. Appropriate errors are provided in the response body.
401The provided credentials were not valid for this endpoint. It may be that they are expired or that the user's roles are insufficient.
409The request conflicts with the current state of the resource. This typically occurs when trying to create a resource that already exists or when there's a conflict with business rules.
422<p>The request was well-formed but contains semantic errors or violates business rules that prevent processing.</p>
500<p>An unexpected internal server error occurred. The request may be retried, and if the problem persists, contact support with the traceId from the error response.</p>
curl --request POST \
--url https://api.upstartcommerce.com/v1/tenants/cfg/templates \
--header 'accept: text/plain' \
--header 'content-type: application/json' \
--header 'x-upstart-tenant: string' \
--data '{
"name": "Cybersource Payment Gateway Configuration",
"propertiesDec": "{\"type\":\"object\",\"properties\":{\"merchantId\":{\"type\":\"string\",\"description\":\"Merchant identifier from Cybersource\",\"pattern\":\"^[a-zA-Z0-9_-]+$\"},\"apiKey\":{\"type\":\"string\",\"description\":\"API key for authentication\",\"format\":\"password\",\"minLength\":32},\"apiUrl\":{\"type\":\"string\",\"format\":\"uri\",\"default\":\"https://api.cybersource.com\",\"description\":\"Cybersource API base URL\"},\"currency\":{\"type\":\"string\",\"enum\":[\"USD\",\"EUR\",\"GBP\"],\"default\":\"USD\",\"description\":\"Default currency for transactions\"},\"testMode\":{\"type\":\"boolean\",\"default\":false,\"description\":\"Enable test mode for development\"}},\"required\":[\"merchantId\",\"apiKey\"]}",
"enabled": true,
"accessControl": {
"read": true,
"modify": false
}
}'