> ## Documentation Index
> Fetch the complete documentation index at: https://auth0.generaltranslation.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Organizationメンバーシップの招待状を送信

> Auth0 DashboardやManagement APIを使用してOrganizationメンバーシップの招待状を送る方法について説明します。

<Tooltip data-tooltip-id="react-containers-DefinitionTooltip-0" href="/docs/ja-JP/ja-jp/glossary?term=auth0-dashboard" tip="Auth0 Dashboard: サービスを構成するためのAuth0の主製品。" cta="用語集の表示">Auth0 Dashboard</Tooltip>または<Tooltip data-tooltip-id="react-containers-DefinitionTooltip-0" href="/docs/ja-JP/ja-jp/glossary?term=management-api" tip="Management API: 顧客が管理タスクを実行できるようにするための製品。" cta="用語集の表示">Management API</Tooltip>を使用して[Organization](/docs/ja-JP/ja-jp/manage-users/organizations/organizations-overview)メンバーシップの招待状を送ることができます。

<div id="auth0-dashboard">
  ## Auth0ダッシュボード
</div>

Auth0 Dashboardを通じてメンバーを招待する方法:

1. [［Auth0 Dashboard］>［Organization］](https://manage.auth0.com/#/organizations)に移動して、メンバーシップを構成したい組織を選択します。
2. **招待状** ビューを選択し、**メンバーの招待** を選択します。
3. メンバーを招待したいアプリケーションを選択し、組織に招待したいメンバーのメールアドレスを入力し **［招待状の送信］** を選択します。

   <Callout icon="file-lines" color="#0EA5E9" iconType="regular">
     任意で、招待を受け入れてもらいたいユーザーの接続を指定したり、招待を受け入れた組織メンバーに割り当てたいロールを指定したりできます。
   </Callout>

<div id="management-api">
  ## Management API
</div>

<Warning>
  アプリケーション用にカスタム開発した管理者ダッシュボードから招待機能を公開する場合は、必ず機密アプリケーションを使用して、認証されたユーザーが新しいメンバーを既に所属している組織に招待していることを確認するか、他のユーザーを招待する権限を、特定のロールが割り当てられているメンバーのみに限定します。
</Warning>

Management APIでメンバーを招待する方法:
Create Organization Invitations（組織への招待状の作成）エンドポイントに`POST`呼び出しを行います。`ORG_ID`、`MGMT_API_ACCESS_TOKEN`、`NAME_OF_USER`、`EMAIL_ADDRESS`、`CLIENT_ID`、`CONNECTION_ID`、`EXP_TIME`、`ROLE_ID`、`SEND_INVITATION_EMAIL_OPTION`プレースホルダー値のそれぞれを組織ID、Management APIアクセストークン、招待されたユーザーの名前、招待されたユーザーのメールアドレス、クライアントID,接続ID,有効期限、役割IDに置き換えてください。

```json lines theme={null}
{
  "method": "POST",
  "url": "https://{yourDomain}/api/v2/organizations/ORG_ID/invitations",
"headers": [
  { "name": "Content-Type", "value": "application/json" },
  { "name": "Authorization", "value": "Bearer MGMT_API_ACCESS_TOKEN" },
  { "name": "Cache-Control", "value": "no-cache" }
  ],
  "postData": {
  "mimeType": "application/json",
  "text" : "{ \"inviter\": { \"name\": \"NAME_OF_USER\"}, \"invitee\": { \"email\": \"EMAIL_ADDRESS\" }, \"client_id\": \"CLIENT_ID\", \"connection_id\": \"CONNECTION_ID\", \"ttl_sec\": \"EXP_TIME\", \"roles\": [ \"ROLE_ID\", \"ROLE_ID\", \"ROLE_ID\" ], \"send_invitation_email\": \"SEND_EMAIL_INVITATION_OPTION\" }"
  }
}
```

<Callout icon="file-lines" color="#0EA5E9" iconType="regular">
  **Auth0ドメインを見つける**

  テナント名がAuth0ドメインである場合は、地域のサブドメイン（テナントが米国地域にあり、2020年6月より前に作成された場合を除く）の後に「`.auth0.com`」が続きます。たとえば、テナント名が「`travel0`」の場合、Auth0のドメイン名は「`travel0.us.auth0.com`」になります。（テナントが米国内にあって、2020年6月よりも前に作成された場合、ドメイン名は「`https://travel0.auth0.com`」になります。）

  カスタムドメインを使用している場合には、これがカスタムドメイン名になります。
</Callout>

<table class="table">
  <thead>
    <tr>
      <th>値</th>
      <th>説明</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>`ORG_ID`</td>
      <td>メンバーシップを割り当てたい組織のIDです。</td>
    </tr>

    <tr>
      <td>`MGMT_API_ACCESS_TOKEN`</td>
      <td>`create:organization_invitations`スコープを含む<a href="/docs/ja-JP/ja-jp/tokens/management-api-access-tokens">Management APIのアクセストークン</a>です。</td>
    </tr>

    <tr>
      <td>`NAME_OF_USER`</td>
      <td>招待を送信したいユーザーの名前です。最大文字数は300文字です。</td>
    </tr>

    <tr>
      <td>`EMAIL_ADDRESS`</td>
      <td>招待の送信先となるメールアドレスです。</td>
    </tr>

    <tr>
      <td>`CLIENT_ID`</td>
      <td>招待されたユーザーの認証が必要となるアプリケーションのIDです。</td>
    </tr>

    <tr>
      <td>`CONNECTION_ID`</td>
      <td>招待されたメンバーの認証に使用する接続のIDです。</td>
    </tr>

    <tr>
      <td>`EXP_TIME`</td>
      <td>招待が期限切れになるまでの秒数です。未指定または0に設定すると、デフォルト値である604800秒（7日）が適用されます。上限は2592000秒（30日）です。</td>
    </tr>

    <tr>
      <td>`ROLE_ID`</td>
      <td>指定された組織で招待されたユーザーに割り当てたいロールのIDです。メンバー1人について50ロールが上限です。</td>
    </tr>

    <tr>
      <td>`SEND_INVITATION_EMAIL_OPTION`</td>
      <td>Auth0がメールを送信するのかを指定します。値は`true`または`false`です。`false`に設定した場合、Auth0が招待のURLを生成し、それを独自のメールサービスでユーザーに送信することができます。</td>
    </tr>
  </tbody>
</table>

<div id="response-status-codes">
  ### 応答ステータスコード
</div>

可能性のある応答ステータスコードは以下の通りです:

<table class="table">
  <thead>
    <tr>
      <th>ステータスコード</th>
      <th>エラーコード</th>
      <th>メッセージ</th>
      <th>原因</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>`200`</td>

      <td />

      <td>Invitation successfully created.（招待が正常に作成されました。）</td>

      <td />
    </tr>

    <tr>
      <td>`400`</td>
      <td>`invalid_body`</td>
      <td>The specified client\_id does not exist.（指定されたclient\_idが存在しません。）</td>
      <td>要求ペイロードが無効です。</td>
    </tr>

    <tr>
      <td>`400`</td>
      <td>`invalid_body`</td>
      <td>The specified connection does not exist.（指定された接続が存在しません。）</td>
      <td>要求ペイロードが無効です。</td>
    </tr>

    <tr>
      <td>`400`</td>
      <td>`invalid_body`</td>
      <td>Passwordless connections are not supported.（パスワードレス接続には対応していません。）</td>
      <td>要求ペイロードが無効です。</td>
    </tr>

    <tr>
      <td>`400`</td>
      <td>`invalid_body`</td>
      <td>A default login route is required to generate the invitation url.（招待URLを生成するには、デフォルトのログインルートが必要です。）詳細については、「<a href="/docs/ja-JP/ja-jp/universal-login/configure-default-login-routes">デフォルトのログインルートを構成する</a>」を参照してください。</td>
      <td>要求ペイロードが無効です。</td>
    </tr>

    <tr>
      <td>`400`</td>
      <td>`invalid_body`</td>
      <td>One or more of the specified roles do not exist: role1, role2'.（指定された1つ以上のロールが存在しません：ロール1、ロール2。）</td>
      <td>要求ペイロードが無効です。</td>
    </tr>

    <tr>
      <td>`400`</td>
      <td>`invalid_body`</td>
      <td>Invalid request body.（要求ボディーが無効です。）メッセージは原因によって異なります。</td>
      <td>要求ペイロードが無効です。</td>
    </tr>

    <tr>
      <td>`400`</td>
      <td>`invalid_query_string`</td>
      <td>Invalid request query string.（要求クエリ文字列が無効です。メッセージは原因によって異なります。クエリ文字列が有効ではありません。</td>

      <td />
    </tr>

    <tr>
      <td>`401`</td>

      <td />

      <td>Invalid token.（無効なトークンです。）</td>

      <td />
    </tr>

    <tr>
      <td>`401`</td>

      <td />

      <td>Invalid signature received for JSON Web Token validation.（JSON Web Tokenの検証に無効な署名を受け取りました。）</td>

      <td />
    </tr>

    <tr>
      <td>`401`</td>

      <td />

      <td>Client is not global.（クライアントがグローバルではありません。）</td>

      <td />
    </tr>

    <tr>
      <td>`403`</td>
      <td>`insufficient_scope`</td>
      <td>Insufficient scope; expected any of: `create:organization_invitations`.（スコープが不足しています。`create:organization_invitations`が必要です。）</td>
      <td>渡されたベアラートークンのスコープでは許可されないフィールドの読み込みや書き出しが試行されました。</td>
    </tr>

    <tr>
      <td>`404`</td>

      <td />

      <td>No organization found by that id.（指定されたIDの組織が存在しません。）</td>

      <td />
    </tr>

    <tr>
      <td>`429`</td>

      <td />

      <td>Too many requests.Check the X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset headers.（要求が多すぎます。X-RateLimit-Limit、X-RateLimit-Remaining、X-RateLimit-Resetヘッダーを確認してください。）</td>

      <td />
    </tr>
  </tbody>
</table>