---
title: Impersonating your Sub-Organizations | PostGrid
description: How to act on behalf of PostGrid sub-organizations via the dashboard or by passing the PostGrid-Org header in API requests.
---

You might want to perform tasks on behalf of your sub-organizations - whether that’s updating templates, sending mail, or handling administrative tasks. PostGrid allows you to do this by impersonating your sub-organizations.

### Prerequisites

- The impersonating user must have the “Admin” role
- Your organization must have impersonation enabled (contact your account manager to enable this)

You can impersonate sub-organizations via the dashboard at this [link](https://dashboard.postgrid.com/login/impersonate) taking you to a login page that looks like this:

![PostGrid impersonation login page with fields for parent organization credentials and the sub-organization user email](/_astro/01-Screenshot_2026-02-04_at_11.17.17.B8xf8hCC_Z1KtOHC.webp)

You can enter your credentials as usual and enter the email of a user of your sub-organization you wish to impersonate.

You can also impersonate by sending API calls on behalf of your sub-organizations. This removes the need to store, secure, and orchestrate multiple credentials for each sub-organization. Add the `PostGrid-Org` header to your API call with the sub-organization ID as the value. For example:

```
/**
 * @param {string} toContactID
 * @param {string} fromContactID
 * @param {string} templateID
 */
async function createLetter(toContactID, fromContactID, templateID, subOrgID) {
  const requestOptions = {
    method: "POST",
    headers: {
      "x-api-key": API_KEY, // Your API Key
      "Content-Type": "application/json",
      "PostGrid-Org": subOrgID,
    },
    body: JSON.stringify({
      to: toContactID,
      from: fromContactID,
      template: templateID,
    }),
  };


  const resp = await fetch(POSTGRID_URL + "/letters", requestOptions);


  return await resp.json();
}
```

## Note

The template ID and contact IDs must belong to your sub-organizations. You cannot use resources from your parent organization, as sub-organizations keep each entity’s resources separate.

You can use PostGrid’s GET endpoints to search and filter by description or metadata to find the resources you need.