Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
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 2.0, at version 2023-12-15.

5 operations 3 paths 20 schemas 1 DELETE2 GET2 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 2.0
API Version
2023-12-15
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 9 params → 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 9 params → 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), CustomObjectDefinitionUpdateActionRequest (9 properties), CustomObjectCustomFieldDefinitionUpdate (9 properties). Each schema is shown below with its type and property counts.

CommonErrorResponse
object
4 properties
CustomObjectCustomFieldDefinitionUpdate
object
The custom field definition in the custom object
9 properties
GETAllCustomObjectDefinitionsInNamespaceResponse
object
2 properties
UpdateCustomObjectCusotmField
object
A reference to a field.
7 properties
PostCustomObjectDefinitionsRequestDefinitions
object
The custom object definitions. This object maps types to custom object definitions.
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…
CustomObjectCustomFieldsDefinition
object
The custom field definition in the custom object definition
PostCustomObjectDefinitionFieldDefinitionRequest
object
6 properties 2 required
PostCustomObjectDefinitionsRequestDefinition
object
10 properties 2 required
CustomObjectAllFieldsDefinition
The definitions of all the fields in the custom object definition
CustomObjectCustomFieldDefinition
object
The custom field definition in the custom object
7 properties
CustomObjectDefinition
object
7 properties
MigrationUpdateCustomObjectDefinitionsRequest
object
1 property 1 required
PostCustomObjectDefinitionFieldsDefinitionRequest
object
CustomObjectDefinitionUpdateActionRequest
object
9 properties 3 required
CustomObjectDefinitions
object
The custom object definitions. This object maps types to custom object definitions.
CustomObjectDefinitionUpdateActionResponse
object
9 properties
PostCustomObjectDefinitionsRequest
object
1 property
FieldsAdditionalProperties
object
Field mappings in the form of : .
MigrationUpdateCustomObjectDefinitionsResponse
object
1 property

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