---
reference:
  curl:
    - key: create_object
      id: create_object
      url: /reference/vault/object/create
      title: /vault/v1/kv
      type: POST
      parameters:
        - (object.name)
        - (object.value)
        - key: key_context
          type: object
          description: (object_metadata.context)
      returns:
        - (object.metadata)
  js:
    - key: createObject
      id: create_object
      url: /reference/vault/object/create
      title: vault.createObject()
      parameters:
        - key: options
          type: object
          unwrap: true
          properties:
            - (Object.name)
            - (Object.value)
            - key: context
              type: object
              description: (object_metadata.context)
      returns:
        - (Object.metadata)
  go:
    - key: CreateObject
      id: create_object
      url: /reference/vault/object/create
      title: vault.CreateObject()
      parameters:
        - (ctx)
        - key: opts
          type: vault.CreateObjectOpts
          expanded: true
          properties:
            - (Object.Name)
            - (Object.Value)
            - key: KeyContext
              type: vault.KeyContext
              description: (object_metadata.context)
      returns:
        - (Object.Metadata)
  python:
    - key: create_object
      id: create_object
      url: /reference/vault/object/create
      title: vault.create_object()
      parameters:
        - key: name
          type: str
          description: (object.name)
        - key: value
          type: str
          description: (object.value)
        - key: key_context
          type: vault.KeyContext
          description: (object_metadata.context)
      returns:
        - (VaultObject.metadata)
originalPath: .tmp-workos-clone/packages/docs/content/reference/vault/object/create.mdx
---

## Create an object

Create a new object, encrypted with the key(s) matching the provided key context.

<CodeBlock referenceId="create_object">
  <CodeBlockTab title="Request" file="create-object-request" />
  <CodeBlockTab title="Response" file="create-object-response" />
</CodeBlock>