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

# Invite To Organization

Invite people to an organization by using their GitHub user ID or their email address. In order to create invitations in an organization, the authenticated user must be an organization owner.

This endpoint triggers [notifications](https://docs.github.com/en/github/managing-subscriptions-and-notifications-on-github/about-notifications). Creating content too quickly using this endpoint may result in secondary rate limiting. See "[Secondary rate limits](https://docs.github.com/rest/overview/resources-in-the-rest-api#secondary-rate-limits)" and "[Dealing with secondary rate limits](https://docs.github.com/rest/guides/best-practices-for-integrators#dealing-with-secondary-rate-limits)" for details.

<Note>
  External Documentation

  To learn more, visit the [GitHub documentation](https://docs.github.com/rest/reference/orgs#create-an-organization-invitation).
</Note>

## Parameters

<div className="integrations-table">
  | Parameter | Description                                                                         |
  | --------- | ----------------------------------------------------------------------------------- |
  | Email     | Email address of the person you are inviting, which can be an existing GitHub user. |
  | Org       | The name of the organization.                                                       |
  | Role      | Specify role for the new member.                                                    |
  | Team IDs  | Specify IDs for the teams you want to invite new members to.                        |
</div>

## Example Output

```json theme={"dark"}
{
	"value": {
		"created_at": "2016-11-30T06:46:10-08:00",
		"email": "octocat@github.com",
		"id": 1,
		"invitation_teams_url": "https://api.github.com/organizations/2/invitations/1/teams",
		"inviter": {
			"avatar_url": "https://github.com/images/error/other_user_happy.gif",
			"events_url": "https://api.github.com/users/other_user/events{/privacy}",
			"followers_url": "https://api.github.com/users/other_user/followers",
			"following_url": "https://api.github.com/users/other_user/following{/other_user}",
			"gists_url": "https://api.github.com/users/other_user/gists{/gist_id}",
			"gravatar_id": "",
			"html_url": "https://github.com/other_user",
			"id": 1,
			"login": "other_user",
			"node_id": "MDQ6VXNlcjE=",
			"organizations_url": "https://api.github.com/users/other_user/orgs",
			"received_events_url": "https://api.github.com/users/other_user/received_events",
			"repos_url": "https://api.github.com/users/other_user/repos",
			"site_admin": false,
			"starred_url": "https://api.github.com/users/other_user/starred{/owner}{/repo}",
			"subscriptions_url": "https://api.github.com/users/other_user/subscriptions",
			"type": "User",
			"url": "https://api.github.com/users/other_user"
		},
		"login": "monalisa",
		"node_id": "MDQ6VXNlcjE=",
		"role": "direct_member",
		"team_count": 2
	}
}
```

## Workflow Library Example

[Onboarding Team Member to Project](https://library.blinkops.com/workflows/onboarding-team-member-to-project)

<div className="iframe-wrapper">
  <div className="iframe-media">
    <img src="https://mintcdn.com/blinkops-2/ojHYuDeYX5FWuN8a/img/Icons/play-box.svg?fit=max&auto=format&n=ojHYuDeYX5FWuN8a&q=85&s=b8af968e71438a9499c3223c9bd29fb2" alt="Workflow Library" width="16" height="16" data-path="img/Icons/play-box.svg" />

    Preview this Workflow on desktop
  </div>

  <iframe className="iframe" src="https://library.blinkops.com/workflows/onboarding-team-member-to-project/canvas" />
</div>