> ## Documentation Index > Fetch the complete documentation index at: https://br.developers.hubspot.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Create a new property > Crie uma nova propriedade para um tipo de objeto especificado em um determinado aplicativo no serviço MediaBridge. Este endpoint permite definir novas propriedades que podem ser usadas para armazenar informações adicionais relacionadas ao tipo de objeto. O corpo da solicitação deve incluir os detalhes necessários da propriedade. > **Supported products** ## OpenAPI ````yaml specs/2026-03/cms-media-bridge-v2026-03.json POST /media-bridge/2026-03/{appId}/properties/{objectType} openapi: 3.0.1 info: title: CMS Media Bridge description: Basepom for all HubSpot Projects version: 2026-03 x-hubspot-product-tier-requirements: marketing: FREE sales: FREE service: FREE cms: FREE commerce: FREE crmHub: FREE dataHub: FREE servers: - url: https://api.hubapi.com security: [] tags: - name: Advanced - name: Basic - name: Batch paths: /media-bridge/2026-03/{appId}/properties/{objectType}: post: tags: - Basic summary: Criar propriedade description: >- Crie uma nova propriedade para um tipo de objeto especificado em um determinado aplicativo no serviço MediaBridge. Este endpoint permite definir novas propriedades que podem ser usadas para armazenar informações adicionais relacionadas ao tipo de objeto. O corpo da solicitação deve incluir os detalhes necessários da propriedade. operationId: post-/media-bridge/2026-03/{appId}/properties/{objectType} parameters: - name: appId in: path description: >- O identificador exclusivo do aplicativo no qual a propriedade será criada. required: true style: simple explode: false schema: type: integer format: int32 - name: objectType in: path description: O tipo de objeto para o qual a propriedade está sendo criada. required: true style: simple explode: false schema: type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/PropertyCreate' required: true responses: '201': description: successful operation headers: Location: description: URL of the newly created resource style: simple explode: false schema: type: string content: application/json: schema: $ref: '#/components/schemas/Property' default: $ref: '#/components/responses/Error' description: '' security: - developer_hapikey: [] components: schemas: PropertyCreate: required: - fieldType - groupName - label - name - type type: object properties: calculationFormula: type: string description: >- Uma string que representa a fórmula usada para calcular o valor da propriedade, aplicável a propriedades calculadas. currencyPropertyName: type: string description: >- Uma string que especifica o nome da propriedade usada para determinar a moeda de propriedades do tipo moeda. dataSensitivity: type: string description: >- Uma string que indica o nível de sensibilidade dos dados, como "PII" (Informações de identificação pessoal). enum: - highly_sensitive - non_sensitive - sensitive description: type: string description: >- Uma string que fornece uma descrição da propriedade, explicando sua finalidade ou uso. displayOrder: type: integer description: >- Um número inteiro que determina a ordem em que a propriedade é exibida em relação a outras propriedades. format: int32 externalOptions: type: boolean description: >- Um booleano que especifica se as opções da propriedade são gerenciadas externamente. fieldType: type: string description: >- Uma string que indica o tipo de campo da propriedade, como 'booleancheckbox', 'calculation_equation', 'checkbox', 'date', 'file', 'html', 'number', 'phonenumber', 'radio', 'select', 'text' ou 'textarea'. enum: - booleancheckbox - calculation_equation - checkbox - date - file - html - number - phonenumber - radio - select - text - textarea formField: type: boolean description: >- Um valor booleano que indica se a propriedade está disponível para uso em formulários. groupName: type: string description: >- O nome do grupo ao qual a propriedade pertence, representado como uma string. hasUniqueValue: type: boolean description: >- Um valor booleano que indica se a propriedade deve ter um valor exclusivo em todos os registros. hidden: type: boolean description: >- Um valor booleano que especifica se a propriedade está oculta das interfaces de usuário. label: type: string description: >- Uma string que representa o rótulo de exibição da propriedade, usada em interfaces de usuário. name: type: string description: >- O nome exclusivo da propriedade. É uma string que identifica a propriedade dentro do tipo de objeto. numberDisplayHint: type: string description: >- Uma string que fornece uma dica para exibir propriedades numéricas, como "unformatted", "formatted", "currency", "percentage", "duration" ou "probability". enum: - currency - duration - formatted - percentage - probability - unformatted options: type: array description: >- Uma matriz de objetos OptionInput, que especifica as opções disponíveis para propriedades do tipo "enumeração". items: $ref: '#/components/schemas/OptionInput' referencedObjectType: type: string description: >- Uma string que indica o tipo de objeto referenciado pela propriedade, se aplicável. showCurrencySymbol: type: boolean description: >- Um valor booleano que indica se um símbolo de moeda deve ser exibido para propriedades do tipo moeda. textDisplayHint: type: string description: >- Uma string que fornece uma dica para exibir propriedades de texto, como 'unformatted_single_line', 'multi_line', 'email', 'phone_number', 'domain_name', 'ip_address', 'physical_address' ou 'postal_code'. enum: - domain_name - email - ip_address - multi_line - phone_number - physical_address - postal_code - unformatted_single_line type: type: string description: >- O tipo de dados da propriedade, que pode ser um de "bool", "date", "datetime", "enumeration", "number", "phone_number" ou "string". enum: - bool - date - datetime - enumeration - number - phone_number - string Property: required: - allowedObjectTypes - calculated - canArchive - canRestore - createdAt - createdUserId - currencyPropertyName - dataSensitivity - dateDisplayHint - deleted - description - displayMode - displayOrder - enforceMultivalueUniqueness - externalOptions - externalOptionsReferenceType - favorited - favoritedOrder - fieldType - formField - fromUserId - groupName - hasUniqueValue - hidden - hubspotDefined - isCustomizedDefault - isMultiValued - isPartial - label - mutableDefinitionNotDeletable - name - numberDisplayHint - optionSortStrategy - options - optionsAreMutable - owningAppId - portalId - readOnlyDefinition - readOnlyValue - referencedObjectType - searchTextAnalysisMode - searchableInGlobalSearch - sensitiveDataCategories - showCurrencySymbol - textDisplayHint - type - updatedAt type: object properties: allowedObjectTypes: type: array description: >- Uma matriz de strings que representa os tipos de objeto permitidos para esta propriedade. items: $ref: '#/components/schemas/ObjectTypeIdProto' calculated: type: boolean description: Booleano que indica se a propriedade é calculada. canArchive: type: boolean description: Um valor booleano que indica se a propriedade pode ser arquivada. canRestore: type: boolean description: Um valor booleano que indica se a propriedade pode ser restaurada. createdAt: type: integer description: >- Uma string que representa a data e a hora em que a propriedade foi criada, no formato ISO 8601. format: int64 createdUserId: type: integer description: Uma string que representa o ID do usuário que criou a propriedade. format: int64 currencyPropertyName: type: string description: >- Uma string que representa o nome da propriedade de moeda associada a esta propriedade. dataSensitivity: type: string description: Uma string que indica o nível de sensibilidade dos dados. enum: - high - none - standard dateDisplayHint: type: string description: Uma string que fornece uma dica para exibir datas. enum: - absolute - absolute_with_relative - time_since - time_until deleted: type: boolean description: Um valor booleano que indica se a propriedade foi excluída. description: type: string description: Uma string que fornece uma descrição da propriedade. displayMode: type: string description: Uma string que indica o modo de exibição da propriedade. enum: - all_unique_versions - current_value displayOrder: type: integer description: >- Um número inteiro que especifica a ordem em que a propriedade é exibida. format: int32 enforceMultivalueUniqueness: type: boolean description: >- Um valor booleano que indica se a exclusividade é aplicada para propriedades de múltiplos valores. externalOptions: type: boolean description: Um valor booleano que indica se a propriedade tem opções externas. externalOptionsReferenceType: type: string description: Uma string que indica o tipo de referência para opções externas. favorited: type: boolean description: >- Um valor booleano que indica se a propriedade foi marcada como favorita. favoritedOrder: type: integer description: >- Um número inteiro que especifica a ordem da propriedade entre os favoritos. format: int32 fieldType: type: string description: >- Uma string que indica o tipo de campo da propriedade, como 'booleancheckbox', 'calculation_equation', 'checkbox', 'date', 'file', 'html', 'number', 'phonenumber', 'radio', 'select', 'text' ou 'textarea'. formField: type: boolean description: >- Um valor booleano que indica se a propriedade é usada como um campo de formulário. fromUserId: type: integer description: Uma string que representa o ID do usuário de origem da propriedade. format: int64 groupName: type: string description: >- Uma string que representa o nome do grupo ao qual a propriedade pertence. hasUniqueValue: type: boolean description: >- Um valor booleano que indica se a propriedade tem um valor exclusivo. hidden: type: boolean description: Um booleano que indica se a propriedade está oculta. example: false hubspotDefined: type: boolean description: >- Um valor booleano que indica se a propriedade é definida pela HubSpot. isCustomizedDefault: type: boolean description: >- Um valor booleano que indica se a propriedade é um padrão personalizado. isMultiValued: type: boolean description: >- Um valor booleano que indica se a propriedade pode ter vários valores. isPartial: type: boolean description: Um booleano que indica se a propriedade é parcial. label: type: string description: >- Uma string que representa o rótulo da propriedade, usada para fins de exibição. mutableDefinitionNotDeletable: type: boolean description: >- Um valor booleano que indica se a definição da propriedade é mutável, mas não pode ser excluída. name: type: string description: Uma string que representa o nome da propriedade. numberDisplayHint: type: string description: >- Uma string que fornece uma dica para exibir números, com opções como "unformatted", "formatted", "currency", "percentage", "duration" ou "probability". enum: - currency - duration - formatted - percentage - probability - unformatted optionSortStrategy: type: string description: Uma string que indica a estratégia usada para classificar as opções. enum: - ALPHABETICAL - DISPLAY_ORDER options: type: array description: >- Uma matriz de opções disponíveis para a propriedade, aplicável se o tipo de propriedade permitir opções. items: $ref: '#/components/schemas/Option' optionsAreMutable: type: boolean description: >- Um valor booleano que indica se as opções da propriedade são mutáveis. owningAppId: type: integer description: >- Um número inteiro que representa o ID do aplicativo proprietário da propriedade. format: int64 portalId: type: integer description: >- Um número inteiro que representa o identificador exclusivo do portal. format: int64 readOnlyDefinition: type: boolean description: >- Um valor booleano que indica se a definição da propriedade é somente leitura. readOnlyValue: type: boolean description: >- Um valor booleano que indica se o valor da propriedade é somente leitura. referencedObjectType: type: string description: >- Uma string que indica o tipo de objeto referenciado pela propriedade. enum: - ABANDONED_CART - ACCEPTANCE_TEST - AD - AD_ACCOUNT - AD_CAMPAIGN - AD_GROUP - AI_FORECAST - ALL_PAGES - APPROVAL - APPROVAL_STEP - ATTRIBUTION - AUDIENCE - AUTOMATION_JOURNEY - AUTOMATION_PLATFORM_FLOW - AUTOMATION_PLATFORM_FLOW_ACTION - BET_ALERT - BET_DELIVERABLE_SERVICE - BLOG_LISTING_PAGE - BLOG_POST - CALL - CAMPAIGN - CAMPAIGN_BUDGET_ITEM - CAMPAIGN_SPEND_ITEM - CAMPAIGN_STEP - CAMPAIGN_TEMPLATE - CAMPAIGN_TEMPLATE_STEP - CART - CASE_STUDY - CHATFLOW - CLIP - CMS_URL - COMBO_EVENT_CONFIGURATION - COMMERCE_PAYMENT - COMMUNICATION - COMPANY - CONTACT - CONTACT_CREATE_ATTRIBUTION - CONTENT - CONTENT_AUDIT - CONTENT_AUDIT_PAGE - CONVERSATION - CONVERSATION_INBOX - CONVERSATION_SESSION - CRM_OBJECTS_DUMMY_TYPE - CRM_PIPELINES_DUMMY_TYPE - CTA - CTA_VARIANT - DATA_PRIVACY_CONSENT - DATA_SYNC_STATE - DEAL - DEAL_CREATE_ATTRIBUTION - DEAL_REGISTRATION - DEAL_SPLIT - DISCOUNT - DISCOUNT_CODE - DISCOUNT_TEMPLATE - EMAIL - ENGAGEMENT - EXPORT - EXTERNAL_WEB_URL - FEE - FEEDBACK_SUBMISSION - FEEDBACK_SURVEY - FILE_MANAGER_FILE - FILE_MANAGER_FOLDER - FOLDER - FORECAST - FORM - FORM_SUBMISSION_INBOUNDDB - GOAL_TARGET - GOAL_TARGET_GROUP - GOAL_TEMPLATE - GSC_PROPERTY - HUB - IMPORT - INVOICE - KEYWORD - KNOWLEDGE_ARTICLE - LANDING_PAGE - LEAD - LINE_ITEM - MARKETING_CALENDAR - MARKETING_CAMPAIGN_UTM - MARKETING_EMAIL - MARKETING_EVENT - MARKETING_EVENT_ATTENDANCE - MARKETING_SMS - MEDIA_BRIDGE - MEETING_EVENT - MIC - NOTE - OBJECT_LIST - ORDER - OWNER - PARTNER_ACCOUNT - PARTNER_CLIENT - PARTNER_CLIENT_REVENUE - PARTNER_SERVICE - PAYMENT_LINK - PAYMENT_SCHEDULE - PAYMENT_SCHEDULE_INSTALLMENT - PERMISSIONS_TESTING - PLAYBOOK - PLAYBOOK_QUESTION - PLAYBOOK_SUBMISSION - PLAYBOOK_SUBMISSION_ANSWER - PLAYLIST - PLAYLIST_FOLDER - PODCAST_EPISODE - PORTAL - PORTAL_OBJECT_SYNC_MESSAGE - POSTAL_MAIL - PRIVACY_SCANNER_COOKIE - PRODUCT - PRODUCT_OR_FOLDER - PROPERTY_INFO - PROSPECTING_AGENT_CONTACT_ASSIGNMENT - PUBLISHING_TASK - QUARANTINED_SUBMISSION - QUOTA - QUOTE - QUOTE_FIELD - QUOTE_MODULE - QUOTE_MODULE_FIELD - QUOTE_TEMPLATE - RESTORABLE_CRM_OBJECT - ROSTER - ROSTER_MEMBER - SALES_DOCUMENT - SALES_TASK - SALES_WORKLOAD - SALESFORCE_SYNC_ERROR - SCHEDULING_PAGE - SCHEMAS_BACKEND_TEST - SCORE_CONFIGURATION - SEQUENCE - SEQUENCE_ENROLLMENT - SEQUENCE_STEP - SEQUENCE_STEP_ENROLLMENT - SERVICE - SITE_PAGE - SNIPPET - SOCIAL_BROADCAST - SOCIAL_CHANNEL - SOCIAL_POST - SOCIAL_PROFILE - SOX_PROTECTED_DUMMY_TYPE - SOX_PROTECTED_TEST_TYPE - SUBMISSION_TAG - SUBSCRIPTION - TASK - TASK_TEMPLATE - TAX - TEMPLATE - TICKET - UNKNOWN - UNSUBSCRIBE - USER - VIEW - VIEW_BLOCK - WEB_INTERACTIVE searchTextAnalysisMode: type: string description: >- Uma string que indica o modo de análise de texto para fins de pesquisa. enum: - NONE - NOT_ANALYZED_TEXT searchableInGlobalSearch: type: boolean description: >- Um valor booleano que indica se a propriedade pode ser pesquisada na pesquisa global. sensitiveDataCategories: type: array description: >- Uma matriz de strings que representa as categorias de dados confidenciais associadas a esta propriedade. items: type: string showCurrencySymbol: type: boolean description: >- Um valor booleano que indica se o símbolo da moeda deve ser exibido para a propriedade. textDisplayHint: type: string description: >- Uma string que fornece uma dica para exibir texto, com opções como "unformatted_single_line", "multi_line", "email", "phone_number", "domain_name", "ip_address", "physical_address" ou "postal_code". enum: - domain_name - email - ip_address - multi_line - phone_number - physical_address - postal_code - unformatted_single_line type: type: string description: >- Uma string que indica o tipo da propriedade, como 'bool', 'date', 'datetime', 'enumeration', 'number', 'phone_number' ou 'string'. enum: - bool - currency_number - date - datetime - enumeration - json - number - object_coordinates - phone_number - string - time_range updatedAt: type: integer description: >- Uma string que representa a data e a hora em que a propriedade foi atualizada pela última vez, no formato ISO 8601. format: int64 description: A HubSpot property OptionInput: required: - displayOrder - hidden - label - value type: object properties: description: type: string description: Uma string que fornece informações adicionais sobre a opção. displayOrder: type: integer description: >- Um número inteiro que indica a ordem em que a opção deve aparecer em relação a outras opções. format: int32 hidden: type: boolean description: >- Um valor booleano que indica se a opção deve ser ocultada da interface do usuário. label: type: string description: O rótulo de exibição da opção, mostrado aos usuários. É uma string. value: type: string description: >- O valor subjacente associado à opção, usado no processamento de dados. É uma string. ObjectTypeIdProto: required: - innerId - metaTypeId type: object properties: innerId: type: integer description: >- Uma propriedade que provavelmente representa um identificador interno para o tipo de objeto. O tipo de dados não é especificado na especificação fornecida. format: int32 metaTypeId: type: integer description: >- Uma propriedade que provavelmente se refere a um identificador de metatipo associado ao tipo de objeto. O tipo de dados não é especificado na especificação fornecida. format: int32 Option: required: - description - displayOrder - doubleData - hidden - label - readOnly - value type: object properties: description: type: string description: Uma string que fornece informações adicionais sobre a opção. displayOrder: type: integer description: >- Um número inteiro que indica a ordem em que a opção deve ser exibida em relação a outras opções. format: int32 doubleData: type: number description: Um número que pode fornecer dados adicionais associados à opção. hidden: type: boolean description: Um booleano que indica se a opção está oculta da exibição. label: type: string description: Uma string que representa o nome de exibição da opção. readOnly: type: boolean description: >- Um booleano que especifica se a opção é somente leitura e não pode ser modificada. value: type: string description: Uma string que representa o valor exclusivo associado à opção. description: A HubSpot property option Error: required: - category - correlationId - message type: object properties: category: type: string description: A categoria de erro context: type: object additionalProperties: type: array items: type: string description: Contexto sobre a condição do erro example: >- {invalidPropertyName=[propertyValue], missingScopes=[scope1, scope2]} correlationId: type: string description: >- Um identificador exclusivo para a solicitação. Inclua este valor em relatórios de erro ou tickets de suporte format: uuid example: aeb5f871-7f07-4993-9211-075dc63e7cbf errors: type: array description: mais informações sobre o erro items: $ref: '#/components/schemas/ErrorDetail' links: type: object additionalProperties: type: string description: >- Um mapa de nomes de links para URIs associados que contêm documentação sobre o erro ou as etapas de correção recomendadas message: type: string description: >- Uma mensagem legível por humanos que descreve o erro, juntamente com as etapas de correção, quando apropriado example: An error occurred subCategory: type: string description: >- Uma categoria específica que contém mais detalhes específicos sobre o erro description: >- Representa uma resposta de erro retornada pela API quando uma operação falha. Este componente é usado em vários endpoints para fornecer informações detalhadas sobre o erro encontrado. example: message: Invalid input (details will vary based on the error) correlationId: aeb5f871-7f07-4993-9211-075dc63e7cbf category: VALIDATION_ERROR links: knowledge-base: https://www.hubspot.com/products/service/knowledge-base ErrorDetail: required: - message type: object properties: code: type: string description: O código de status associado ao detalhe do erro context: type: object additionalProperties: type: array items: type: string description: Contexto sobre a condição do erro example: '{missingScopes=[scope1, scope2]}' in: type: string description: O nome do campo ou parâmetro no qual o erro foi encontrado. message: type: string description: >- Uma mensagem legível por humanos que descreve o erro, juntamente com as etapas de correção, quando apropriado subCategory: type: string description: >- Uma categoria específica que contém mais detalhes específicos sobre o erro description: >- Representa informações detalhadas sobre um erro ocorrido na API. Este componente é usado para fornecer contexto e detalhes adicionais sobre os erros, geralmente como parte de uma resposta de erro. responses: Error: description: An error occurred. content: '*/*': schema: $ref: '#/components/schemas/Error' securitySchemes: developer_hapikey: type: apiKey name: hapikey in: query ````