---
descriptions:
  create_client_secret:
    id_parameter: The application ID or client ID.
reference:
  curl:
    - key: create_client_secret
      type: POST
      id: create_client_secret
      url: /reference/workos-connect/applications/client-secrets/create
      title: '/connect/applications/:id/client_secrets'
      parameters:
        - key: id
          type: string
          description: (create_client_secret.id_parameter)
      returns:
        - key: connect_application_secret
          type: object
          description: A connect_application_secret object with the plaintext secret
          properties:
            - key: object
              type: string
              description: Always "connect_application_secret"
            - key: id
              type: string
              description: Unique identifier for the client secret
            - key: secret
              type: string
              description: The plaintext client secret (only returned at creation time)
            - key: secret_hint
              type: string
              description: A hint showing the first few characters of the secret
            - key: last_used_at
              type: string | null
              description: ISO 8601 timestamp of when the secret was last used
            - key: created_at
              type: string
              description: ISO 8601 timestamp of creation
            - key: updated_at
              type: string
              description: ISO 8601 timestamp of last update
originalPath: >-
  .tmp-workos-clone/packages/docs/content/reference/workos-connect/applications/client-secrets/create.mdx
---

## Create a Client Secret

Create a new client secret for a Connect Application.

This is the only time the plaintext secret will be returned and must be stored securely.

<CodeBlock referenceId="create_client_secret">
  <CodeBlockTab title="Request" file="create-client-secret-request" />
  <CodeBlockTab title="Response" file="create-client-secret-response" />
</CodeBlock>