---
id: sources-user-connections-saml-create
title: "sources_user_connections_saml_create"
description: "Source Viewset"
sidebar_label: "sources_user_connections_saml_create"
hide_title: true
hide_table_of_contents: true
api: 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
sidebar_class_name: "post api-method"
info_path: docs/developer-docs/api/reference/authentik
custom_edit_url: null
hide_send_button: true
---

import ApiTabs from "@theme/ApiTabs";
import DiscriminatorTabs from "@theme/DiscriminatorTabs";
import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint";
import SecuritySchemes from "@theme/ApiExplorer/SecuritySchemes";
import MimeTabs from "@theme/MimeTabs";
import ParamsItem from "@theme/ParamsItem";
import ResponseSamples from "@theme/ResponseSamples";
import SchemaItem from "@theme/SchemaItem";
import SchemaTabs from "@theme/SchemaTabs";
import Heading from "@theme/Heading";
import OperationTabs from "@theme/OperationTabs";
import TabItem from "@theme/TabItem";

<Heading
  as={"h1"}
  className={"openapi__heading"}
  children={"sources_user_connections_saml_create"}
>
</Heading>

<MethodEndpoint
  method={"post"}
  path={"/sources/user_connections/saml/"}
>
  
</MethodEndpoint>



Source Viewset

<Heading
  id={"request"}
  as={"h2"}
  className={"openapi-tabs__heading"}
  children={"Request"}
>
</Heading>

<MimeTabs
  className={"openapi-tabs__mime"}
>
  <TabItem
    label={"application/json"}
    value={"application/json-schema"}
  >
    <details
      style={{}}
      className={"openapi-markdown__details mime"}
      data-collapsed={false}
      open={true}
    >
      <summary
        style={{}}
        className={"openapi-markdown__details-summary-mime"}
      >
        <h3
          className={"openapi-markdown__details-summary-header-body"}
        >
          Body
        </h3><strong
          className={"openapi-schema__required"}
        >
          required
        </strong>
      </summary><div
        style={{"textAlign":"left","marginLeft":"1rem"}}
      >
        
      </div><ul
        style={{"marginLeft":"1rem"}}
      >
        <SchemaItem
          collapsible={false}
          name={"identifier"}
          required={true}
          schemaName={"string"}
          qualifierMessage={"**Possible values:** `non-empty`"}
          schema={{"type":"string","minLength":1}}
        >
          
        </SchemaItem>
      </ul>
    </details>
  </TabItem>
</MimeTabs><div>
  <div>
    <ApiTabs
      label={undefined}
      id={undefined}
    >
      <TabItem
        label={"201"}
        value={"201"}
      >
        <div>
          
          
          
          
          
        </div><div>
          <MimeTabs
            className={"openapi-tabs__mime"}
            schemaType={"response"}
          >
            <TabItem
              label={"application/json"}
              value={"application/json"}
            >
              <SchemaTabs
                className={"openapi-tabs__schema"}
              >
                <TabItem
                  label={"Schema"}
                  value={"Schema"}
                >
                  <details
                    style={{}}
                    className={"openapi-markdown__details response"}
                    data-collapsed={false}
                    open={true}
                  >
                    <summary
                      style={{}}
                      className={"openapi-markdown__details-summary-response"}
                    >
                      <strong>
                        Schema
                      </strong>
                    </summary><div
                      style={{"textAlign":"left","marginLeft":"1rem"}}
                    >
                      
                    </div><ul
                      style={{"marginLeft":"1rem"}}
                    >
                      <SchemaItem
                        collapsible={false}
                        name={"pk"}
                        required={true}
                        schemaName={"ID (integer)"}
                        qualifierMessage={undefined}
                        schema={{"type":"integer","readOnly":true,"title":"ID"}}
                      >
                        
                      </SchemaItem><SchemaItem
                        collapsible={false}
                        name={"user"}
                        required={true}
                        schemaName={"integer"}
                        qualifierMessage={undefined}
                        schema={{"type":"integer","readOnly":true}}
                      >
                        
                      </SchemaItem><SchemaItem
                        collapsible={true}
                        className={"schemaItem"}
                      >
                        <details
                          style={{}}
                          className={"openapi-markdown__details"}
                        >
                          <summary
                            style={{}}
                          >
                            <span
                              className={"openapi-schema__container"}
                            >
                              <strong
                                className={"openapi-schema__property"}
                              >
                                source
                              </strong><span
                                className={"openapi-schema__name"}
                              >
                                 object
                              </span><span
                                className={"openapi-schema__divider"}
                              >
                                
                              </span><span
                                className={"openapi-schema__required"}
                              >
                                required
                              </span>
                            </span>
                          </summary><div
                            style={{"marginLeft":"1rem"}}
                          >
                            <div
                              style={{"marginTop":".5rem","marginBottom":".5rem"}}
                            >
                              
                              
                              Source Serializer
                              
                              
                            </div><SchemaItem
                              collapsible={false}
                              name={"pk"}
                              required={true}
                              schemaName={"uuid"}
                              qualifierMessage={undefined}
                              schema={{"type":"string","format":"uuid","readOnly":true,"title":"Pbm uuid"}}
                            >
                              
                            </SchemaItem><SchemaItem
                              collapsible={false}
                              name={"name"}
                              required={true}
                              schemaName={"string"}
                              qualifierMessage={undefined}
                              schema={{"type":"string","description":"Source's display Name."}}
                            >
                              
                            </SchemaItem><SchemaItem
                              collapsible={false}
                              name={"slug"}
                              required={true}
                              schemaName={"string"}
                              qualifierMessage={"**Possible values:** `<= 50 characters`, Value must match regular expression `^[-a-zA-Z0-9_]+$`"}
                              schema={{"type":"string","description":"Internal source name, used in URLs.","maxLength":50,"pattern":"^[-a-zA-Z0-9_]+$"}}
                            >
                              
                            </SchemaItem><SchemaItem
                              collapsible={false}
                              name={"enabled"}
                              required={false}
                              schemaName={"boolean"}
                              qualifierMessage={undefined}
                              schema={{"type":"boolean"}}
                            >
                              
                            </SchemaItem><SchemaItem
                              collapsible={false}
                              name={"authentication_flow"}
                              required={false}
                              schemaName={"uuid"}
                              qualifierMessage={undefined}
                              schema={{"type":"string","format":"uuid","nullable":true,"description":"Flow to use when authenticating existing users."}}
                            >
                              
                            </SchemaItem><SchemaItem
                              collapsible={false}
                              name={"enrollment_flow"}
                              required={false}
                              schemaName={"uuid"}
                              qualifierMessage={undefined}
                              schema={{"type":"string","format":"uuid","nullable":true,"description":"Flow to use when enrolling new users."}}
                            >
                              
                            </SchemaItem><SchemaItem
                              collapsible={false}
                              name={"user_property_mappings"}
                              required={false}
                              schemaName={"uuid[]"}
                              qualifierMessage={undefined}
                              schema={{"type":"array","items":{"type":"string","format":"uuid"}}}
                            >
                              
                            </SchemaItem><SchemaItem
                              collapsible={false}
                              name={"group_property_mappings"}
                              required={false}
                              schemaName={"uuid[]"}
                              qualifierMessage={undefined}
                              schema={{"type":"array","items":{"type":"string","format":"uuid"}}}
                            >
                              
                            </SchemaItem><SchemaItem
                              collapsible={false}
                              name={"component"}
                              required={true}
                              schemaName={"string"}
                              qualifierMessage={undefined}
                              schema={{"type":"string","description":"Get object component so that we know how to edit the object","readOnly":true}}
                            >
                              
                            </SchemaItem><SchemaItem
                              collapsible={false}
                              name={"verbose_name"}
                              required={true}
                              schemaName={"string"}
                              qualifierMessage={undefined}
                              schema={{"type":"string","description":"Return object's verbose_name","readOnly":true}}
                            >
                              
                            </SchemaItem><SchemaItem
                              collapsible={false}
                              name={"verbose_name_plural"}
                              required={true}
                              schemaName={"string"}
                              qualifierMessage={undefined}
                              schema={{"type":"string","description":"Return object's plural verbose_name","readOnly":true}}
                            >
                              
                            </SchemaItem><SchemaItem
                              collapsible={false}
                              name={"meta_model_name"}
                              required={true}
                              schemaName={"string"}
                              qualifierMessage={undefined}
                              schema={{"type":"string","description":"Return internal model name","readOnly":true}}
                            >
                              
                            </SchemaItem><SchemaItem
                              collapsible={false}
                              name={"policy_engine_mode"}
                              required={false}
                              schemaName={"PolicyEngineMode (string)"}
                              qualifierMessage={"**Possible values:** [`all`, `any`]"}
                              schema={{"enum":["all","any"],"type":"string","title":"PolicyEngineMode"}}
                            >
                              
                            </SchemaItem><SchemaItem
                              collapsible={false}
                              name={"user_matching_mode"}
                              required={false}
                              schemaName={"UserMatchingModeEnum (string)"}
                              qualifierMessage={"**Possible values:** [`identifier`, `email_link`, `email_deny`, `username_link`, `username_deny`]"}
                              schema={{"description":"How the source determines if an existing user should be authenticated or a new user enrolled.","enum":["identifier","email_link","email_deny","username_link","username_deny"],"type":"string","title":"UserMatchingModeEnum"}}
                            >
                              
                            </SchemaItem><SchemaItem
                              collapsible={false}
                              name={"managed"}
                              required={true}
                              schemaName={"Managed by authentik (string)"}
                              qualifierMessage={undefined}
                              schema={{"type":"string","nullable":true,"title":"Managed by authentik","description":"Objects that are managed by authentik. These objects are created and updated automatically. This flag only indicates that an object can be overwritten by migrations. You can still modify the objects via the API, but expect changes to be overwritten in a later update.","readOnly":true}}
                            >
                              
                            </SchemaItem><SchemaItem
                              collapsible={false}
                              name={"user_path_template"}
                              required={false}
                              schemaName={"string"}
                              qualifierMessage={undefined}
                              schema={{"type":"string"}}
                            >
                              
                            </SchemaItem><SchemaItem
                              collapsible={false}
                              name={"icon"}
                              required={true}
                              schemaName={"string"}
                              qualifierMessage={undefined}
                              schema={{"type":"string","nullable":true,"description":"Get the URL to the Icon. If the name is /static or\nstarts with http it is returned as-is","readOnly":true}}
                            >
                              
                            </SchemaItem>
                          </div>
                        </details>
                      </SchemaItem><SchemaItem
                        collapsible={false}
                        name={"created"}
                        required={true}
                        schemaName={"date-time"}
                        qualifierMessage={undefined}
                        schema={{"type":"string","format":"date-time","readOnly":true}}
                      >
                        
                      </SchemaItem><SchemaItem
                        collapsible={false}
                        name={"identifier"}
                        required={true}
                        schemaName={"string"}
                        qualifierMessage={undefined}
                        schema={{"type":"string"}}
                      >
                        
                      </SchemaItem>
                    </ul>
                  </details>
                </TabItem><TabItem
                  label={"Example (from schema)"}
                  value={"Example (from schema)"}
                >
                  <ResponseSamples
                    responseExample={"{\n  \"pk\": 0,\n  \"user\": 0,\n  \"source\": {\n    \"pk\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n    \"name\": \"string\",\n    \"slug\": \"string\",\n    \"enabled\": true,\n    \"authentication_flow\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n    \"enrollment_flow\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n    \"user_property_mappings\": [\n      \"3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n    ],\n    \"group_property_mappings\": [\n      \"3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n    ],\n    \"component\": \"string\",\n    \"verbose_name\": \"string\",\n    \"verbose_name_plural\": \"string\",\n    \"meta_model_name\": \"string\",\n    \"policy_engine_mode\": \"all\",\n    \"user_matching_mode\": \"identifier\",\n    \"managed\": \"string\",\n    \"user_path_template\": \"string\",\n    \"icon\": \"string\"\n  },\n  \"created\": \"2024-07-29T15:51:28.071Z\",\n  \"identifier\": \"string\"\n}"}
                    language={"json"}
                  >
                    
                  </ResponseSamples>
                </TabItem>
              </SchemaTabs>
            </TabItem>
          </MimeTabs>
        </div>
      </TabItem><TabItem
        label={"400"}
        value={"400"}
      >
        <div>
          
          
          
          
          
        </div><div>
          <MimeTabs
            className={"openapi-tabs__mime"}
            schemaType={"response"}
          >
            <TabItem
              label={"application/json"}
              value={"application/json"}
            >
              <SchemaTabs
                className={"openapi-tabs__schema"}
              >
                <TabItem
                  label={"Schema"}
                  value={"Schema"}
                >
                  <details
                    style={{}}
                    className={"openapi-markdown__details response"}
                    data-collapsed={false}
                    open={true}
                  >
                    <summary
                      style={{}}
                      className={"openapi-markdown__details-summary-response"}
                    >
                      <strong>
                        Schema
                      </strong>
                    </summary><div
                      style={{"textAlign":"left","marginLeft":"1rem"}}
                    >
                      
                    </div><ul
                      style={{"marginLeft":"1rem"}}
                    >
                      <SchemaItem
                        collapsible={false}
                        name={"non_field_errors"}
                        required={false}
                        schemaName={"string[]"}
                        qualifierMessage={undefined}
                        schema={{"type":"array","items":{"type":"string"}}}
                      >
                        
                      </SchemaItem><SchemaItem
                        collapsible={false}
                        name={"code"}
                        required={false}
                        schemaName={"string"}
                        qualifierMessage={undefined}
                        schema={{"type":"string"}}
                      >
                        
                      </SchemaItem><SchemaItem
                        name={"property name*"}
                        required={false}
                        schemaName={"any"}
                        qualifierMessage={undefined}
                        schema={{"type":"object","description":"Validation Error","properties":{"non_field_errors":{"type":"array","items":{"type":"string"}},"code":{"type":"string"}},"additionalProperties":{},"title":"ValidationError"}}
                        collapsible={false}
                        discriminator={false}
                      >
                        
                      </SchemaItem>
                    </ul>
                  </details>
                </TabItem><TabItem
                  label={"Example (from schema)"}
                  value={"Example (from schema)"}
                >
                  <ResponseSamples
                    responseExample={"{\n  \"non_field_errors\": [\n    \"string\"\n  ],\n  \"code\": \"string\"\n}"}
                    language={"json"}
                  >
                    
                  </ResponseSamples>
                </TabItem>
              </SchemaTabs>
            </TabItem>
          </MimeTabs>
        </div>
      </TabItem><TabItem
        label={"403"}
        value={"403"}
      >
        <div>
          
          
          
          
          
        </div><div>
          <MimeTabs
            className={"openapi-tabs__mime"}
            schemaType={"response"}
          >
            <TabItem
              label={"application/json"}
              value={"application/json"}
            >
              <SchemaTabs
                className={"openapi-tabs__schema"}
              >
                <TabItem
                  label={"Schema"}
                  value={"Schema"}
                >
                  <details
                    style={{}}
                    className={"openapi-markdown__details response"}
                    data-collapsed={false}
                    open={true}
                  >
                    <summary
                      style={{}}
                      className={"openapi-markdown__details-summary-response"}
                    >
                      <strong>
                        Schema
                      </strong>
                    </summary><div
                      style={{"textAlign":"left","marginLeft":"1rem"}}
                    >
                      
                    </div><ul
                      style={{"marginLeft":"1rem"}}
                    >
                      <SchemaItem
                        collapsible={false}
                        name={"detail"}
                        required={true}
                        schemaName={"string"}
                        qualifierMessage={undefined}
                        schema={{"type":"string"}}
                      >
                        
                      </SchemaItem><SchemaItem
                        collapsible={false}
                        name={"code"}
                        required={false}
                        schemaName={"string"}
                        qualifierMessage={undefined}
                        schema={{"type":"string"}}
                      >
                        
                      </SchemaItem>
                    </ul>
                  </details>
                </TabItem><TabItem
                  label={"Example (from schema)"}
                  value={"Example (from schema)"}
                >
                  <ResponseSamples
                    responseExample={"{\n  \"detail\": \"string\",\n  \"code\": \"string\"\n}"}
                    language={"json"}
                  >
                    
                  </ResponseSamples>
                </TabItem>
              </SchemaTabs>
            </TabItem>
          </MimeTabs>
        </div>
      </TabItem>
    </ApiTabs>
  </div>
</div>