How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Zuora Custom Object Definitions API

With Custom Objects service, you can define custom objects, extending the Zuora data model to accommodate your specific use cases.If you use Postman, you can import the custom objects endpoints as a collection into your Postman app and try out different requests to learn how the API works. Click the following button to get started:[![Run in Postman](https://run.pstmn.io/button.svg)](https://www.getpostman.com/run-collection/1f068ba43651bf63c0d4)You can sign up for a free account on the [Postman website](https://identity.getpostman.com/signup) and download the app in case you do not use Postman yet.Note that the Custom Object Definitions API is versioned by `Zuora-Version` in the request header. The response may be different for the same request with a different API version. Specify `Zuora-Version` in the request header if you expect a specific response schema.### Error handling If the Custom Objects API call fails, an error code will be returned in the response body. See [Custom Objects API error code](https://knowledgecenter.zuora.com/Central_Platform/Custom_Objects/Z_Custom_Objects_API#Custom_Objects_API_error_code) for details.

Zuora Custom Object Definitions API is one of 80 APIs that Zuora publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Custom Object Definitions. The published artifact set on APIs.io includes an OpenAPI specification.

This API exposes 5 operations across 3 paths, and defines 20 schemas. It is described by OpenAPI 3.2.0, at version 2023-12-15.

Requests are made against a single base URL, https://rest.zuora.com/.

5 operations 3 paths 20 schemas 1 DELETE2 GET2 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
2023-12-15
Server
https://rest.zuora.com/
Resource Areas
1

Paths & Operations 5

Across 3 paths, the API surfaces 5 operations — 1 DELETE, 2 GET, 2 POST. Each is listed below with its method, path, parameters, and response codes.

Custom Object Definitions 5

With Custom Objects service, you can define custom objects, extending the Zuora data model to accommodate your specific use cases. If you use Postman, you can import the custom ob…

GET
/objects/definitions/default
List custom object definitions
GET_AllCustomObjectDefinitionsInNamespace 8 params → 200
POST
/objects/definitions/default
Create custom object definitions
POST_CustomObjectDefinitions 8 params body → 200400
GET
/objects/definitions/default/{object}
Retrieve a custom object definition
GET_CustomObjectDefinitionByType 8 params → 200404
DELETE
/objects/definitions/default/{object}
Delete a custom object definition
Delete_CustomObjectDefinitionByType 8 params → 200
POST
/objects/migrations
Update a custom object definition
POST_UpdateCustomObjectDefinition 8 params body → 200

Schemas 20

The contract defines 20 schemas that model the data the API accepts and returns. The most detailed are PostCustomObjectDefinitionsRequestDefinition (10 properties), CustomObjectDefinitionUpdateActionResponse (9 properties), CustomObjectCustomFieldDefinitionUpdate (9 properties), CustomObjectDefinitionUpdateActionRequest (9 properties). Each schema is shown below with its type and property counts.

CustomObjectAllFieldsDefinition
The definitions of all the fields in the custom object definition
CustomObjectCustomFieldDefinitionUpdate
object
The custom field definition in the custom object
9 properties
CustomObjectDefinition
object
7 properties
CustomObjectDefinitionUpdateActionResponse
object
9 properties
MigrationUpdateCustomObjectDefinitionsRequest
object
1 property 1 required
PostCustomObjectDefinitionsRequestDefinitions
object
The custom object definitions. This object maps types to custom object definitions.
PostCustomObjectDefinitionFieldsDefinitionRequest
object
CustomObjectCustomFieldsDefinition
object
The custom field definition in the custom object definition
PostCustomObjectDefinitionFieldDefinitionRequest
object
6 properties 2 required
FieldsAdditionalPropertiesForPostDefinition
object
Field mappings in the form of : . Usually the can only be the Id field of the related object. Two exceptions are Subscription Name and Rate Plan Charge Number…
PostCustomObjectDefinitionsRequest
object
1 property
CustomObjectDefinitions
object
The custom object definitions. This object maps types to custom object definitions.
UpdateCustomObjectCusotmField
object
A reference to a field.
7 properties
CustomObjectDefinitionUpdateActionRequest
object
9 properties 3 required
CommonErrorResponse
object
4 properties
MigrationUpdateCustomObjectDefinitionsResponse
object
1 property
CustomObjectCustomFieldDefinition
object
The custom field definition in the custom object
7 properties
FieldsAdditionalProperties
object
Field mappings in the form of : .
PostCustomObjectDefinitionsRequestDefinition
object
10 properties 2 required
GETAllCustomObjectDefinitionsInNamespaceResponse
object
2 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

zuora-custom-object-definitions-api-openapi.yml Raw ↑

Other APIs Zuora publishes across the network.

Zuora V1 API
Zuora Accounting Codes API
Zuora Accounting Periods API
Zuora Accounts API
Zuora Actions API
Zuora Aggregate Queries API
Zuora API Health API
Zuora Attachments API
Zuora Bill Run API
Zuora Bill Run Health API
Zuora Billing Documents API
Zuora Billing Preview Run API
Where this information came from

This is an independent, third-party profile of Zuora Custom Object Definitions API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.