title | description | author | ms.localizationpriority | ms.subservice | doc_type |
---|---|---|---|---|---|
Create externalDomainName |
Create a new externalDomainName object. |
namkedia |
medium |
entra-sign-in |
apiPageType |
Namespace: microsoft.graph
Add multiple domains to your SAML or WS-Fed based configuration by creating a new externalDomainName object and add it to an existing samlOrWsFedExternalDomainFederation.
Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions only if your app requires it. For details about delegated and application permissions, see Permission types. To learn more about these permissions, see the permissions reference.
[!INCLUDE permissions-table]
[!INCLUDE rbac-identity-provider-apis]
POST /directory/federationConfigurations/{samlOrWsFedExternalDomainFederation ID}/microsoft.graph.samlOrWsFedExternalDomainFederation/domains
Name | Description |
---|---|
Authorization | Bearer {token}. Required. Learn more about authentication and authorization. |
Content-Type | application/json. Required. |
In the request body, supply a JSON representation of the externalDomainName object.
The following table lists the properties that are required when you create the externalDomainName.
Property | Type | Description |
---|---|---|
id | String | Domain name of the external organization you want to add to your samlOrWsFedExternalDomainFederation. Inherited from entity. |
If successful, this method returns a 201 Created
response code and an externalDomainName object in the response body.
POST https://graph.microsoft.com/beta/directory/federationConfigurations/d5a56845-6845-d5a5-4568-a5d54568a5d5/microsoft.graph.samlOrWsFedExternalDomainFederation/domains
Content-Type: application/json
{
"@odata.type": "microsoft.graph.externalDomainName",
"id": "contososuites.com"
}
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
The following example shows the response.
Note: The response object shown here might be shortened for readability.
HTTP/1.1 201 Created
Content-Type: application/json
{
"@odata.type": "#microsoft.graph.externalDomainName",
"id": "contososuites.com"
}