Database.com Metadata API Developer's Guide - Salesforce.com

Chapter 7CRUD-Based CallsUse the following CRUD-based calls to work with metadata components in a manner similar to how synchronous API callsin the enterprise WSDL act upon objects.create()Adds one or more new metadata components to your organization asynchronously.This call can be used to create any of the objects that extend Metadata. For more details, see Metadata Components and Typeson page 75.SyntaxAsyncResult[] = metadatabinding.create(Metadata[] metadata);UsageUse this call to add one or more metadata components to your organization.PermissionsYour client application must be logged in with the “Modify All Data” permission.Required FieldsRequired fields are determined by the metadata components being created. For more information about specific componenttypes, see Metadata Components and Types on page 75.Valid Data ValuesYou must supply values that are valid for the field’s data type, such as integers for integer fields (not alphabetic characters). Inyour client application, follow the data formatting rules specified for your programming language and development tool (yourdevelopment tool handles the appropriate mapping of data types in SOAP messages).String ValuesWhen storing values in string fields, the API trims any leading and trailing whitespace. For example, if the value of a labelfield is entered as "MyObject " the value is stored in the database as "MyObject".Basic Steps for Creating Metadata ComponentsUse the following process to create metadata components:1. Design an array and populate it with the components you want to create. All components must be of the same type.2. Call create() with the component array passed in as an argument.42