> ## Documentation Index
> Fetch the complete documentation index at: https://www.c1.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Email Capabilities

> GetEmailCapabilities returns a lightweight summary of email capabilities
 for the current tenant. Intended for non-admin users (automation builders,
 secret sharers) to check if external email is available without exposing
 provider configuration details.



## OpenAPI

````yaml https://spec.speakeasy.com/conductor-one/conductorone/my-source-with-code-samples get /api/v1/settings/email-capabilities
openapi: 3.1.0
info:
  description: The C1 API is a HTTP API for managing C1 resources.
  title: C1 API
  version: 0.1.0-alpha
servers:
  - description: The C1 API server for the current tenant.
    url: https://{tenantDomain}.conductor.one
    variables:
      tenantDomain:
        default: example
        description: The domain of the tenant to use for this request.
security:
  - bearerAuth: []
    oauth: []
paths:
  /api/v1/settings/email-capabilities:
    get:
      tags:
        - Tenant Email Provider
      summary: Get Email Capabilities
      description: |-
        GetEmailCapabilities returns a lightweight summary of email capabilities
         for the current tenant. Intended for non-admin users (automation builders,
         secret sharers) to check if external email is available without exposing
         provider configuration details.
      operationId: c1.api.settings.v1.TenantEmailProviderService.GetEmailCapabilities
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/c1.api.settings.v1.GetEmailCapabilitiesResponse
          description: Successful response
      x-codeSamples:
        - lang: go
          label: GetEmailCapabilities
          source: "package main\n\nimport(\n\t\"context\"\n\t\"github.com/conductorone/conductorone-sdk-go/pkg/models/shared\"\n\tconductoronesdkgo \"github.com/conductorone/conductorone-sdk-go\"\n\t\"log\"\n)\n\nfunc main() {\n    ctx := context.Background()\n\n    s := conductoronesdkgo.New(\n        conductoronesdkgo.WithSecurity(shared.Security{\n            BearerAuth: \"<YOUR_BEARER_TOKEN_HERE>\",\n            Oauth: \"<YOUR_OAUTH_HERE>\",\n        }),\n    )\n\n    res, err := s.TenantEmailProvider.GetEmailCapabilities(ctx)\n    if err != nil {\n        log.Fatal(err)\n    }\n    if res.GetEmailCapabilitiesResponse != nil {\n        // handle response\n    }\n}"
        - lang: typescript
          label: Typescript (SDK)
          source: >-
            import { ConductoroneSDKTypescript } from
            "conductorone-sdk-typescript";


            const conductoroneSDKTypescript = new ConductoroneSDKTypescript({
              security: {
                bearerAuth: "<YOUR_BEARER_TOKEN_HERE>",
                oauth: "<YOUR_OAUTH_HERE>",
              },
            });


            async function run() {
              const result = await conductoroneSDKTypescript.tenantEmailProvider.getEmailCapabilities();

              console.log(result);
            }


            run();
components:
  schemas:
    c1.api.settings.v1.GetEmailCapabilitiesResponse:
      description: The GetEmailCapabilitiesResponse message.
      properties:
        externalEmailSupported:
          description: |-
            True when external email addresses (outside C1 users) can be used as
             recipients in automation email steps. False when only the C1 built-in
             provider is configured (C1 users only).
          readOnly: false
          type: boolean
      title: Get Email Capabilities Response
      type: object
      x-speakeasy-name-override: GetEmailCapabilitiesResponse
  securitySchemes:
    bearerAuth:
      scheme: bearer
      type: http
    oauth:
      description: >-
        This API uses OAuth2 with the Client Credential flow.

        Client Credentials must be sent in the BODY, not the headers.

        For an example of how to implement this, refer to the
        [c1TokenSource.Token()](https://github.com/ConductorOne/conductorone-sdk-go/blob/3375fe7c0126d17e7ec4e711693dee7b791023aa/token_source.go#L101-L187)
        function.
      flows:
        clientCredentials:
          scopes: {}
          tokenUrl: /auth/v1/token
      type: oauth2

````