> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

# Method name: findOrCreateLabel(displayName: string, options: AuthOptions)

# Method package: wixCrmBackend

# Method menu location: wixCrmBackend --> Contacts --> findOrCreateLabel

# Method Link: https://dev.wix.com/docs/velo/apis/wix-crm-backend/contacts/find-or-create-label.md

# Method Description:

Retrieves a label with a given name, or creates one if it doesn't exist.




The `findOrCreateLabel()` function returns a Promise
that resolves when the specified label is found or created.

Successful calls to `findOrCreateLabel()` always return a label,
which can be passed to subsequent function calls.

To find an existing label without potentially creating a new one, use
[`getLabel()`](wix-crm-backend/contacts/get-label) or
[`queryLabels()`](wix-crm-backend/contacts/query-labels).


> **Note:**
> Only visitors with
> **Manage Contacts** [permissions](https://www.wix.com/my-account/site-selector/?buttonText=Select%20Site&title=Select%20a%20Site&autoSelectOnSingleSite=true&actionUrl=https:%2F%2Fwww.wix.com%2Fdashboard%2F%7B%7BmetaSiteId%7D%7D%2Froles-and-permissions)
> can find or create labels.
> You can override the permissions by setting the `suppressAuth` option to `true`.



# Method Code Examples:

*** Note: do not assume any prop names or enum values other than the ones in the example.

## Create a label

```javascript
import { Permissions, webMethod } from 'wix-web-module';
import { contacts } from 'wix-crm-backend';

export const myFindOrCreateLabelFunction = webMethod(Permissions.Anyone, () => {
  const displayName = "Active Customer";
  const options = {
    suppressAuth: false
  };

  return contacts.findOrCreateLabel(displayName, options)
    .then((label) => {
      return label;
    })
    .catch((error) => {
      console.error(error);
    });
});

/*
 * Promise resolves to:
 *
 * {
 *   "label": {
 *     "_createdDate": "2021-01-20T00:31:41.452Z",
 *     "_updatedDate": "2021-01-20T00:31:41.452Z"
 *     "namespace": "custom",
 *     "key": "custom.active-customer",
 *     "displayName": "Active Customer",
 *     "labelType": "USER_DEFINED"
 *   },
 *   "newLabel": true
 * }
 */
```

## Find a label

```javascript
import { Permissions, webMethod } from 'wix-web-module';
import { contacts } from 'wix-crm-backend';

export const myFindOrCreateLabelFunction = webMethod(Permissions.Anyone, () => {
  const displayName = "Active Customer";
  const options = {
    suppressAuth: false
  };

  return contacts.findOrCreateLabel(displayName, options)
    .then((label) => {
      return label;
    })
    .catch((error) => {
      console.error(error);
    });
});

/*
 * Promise resolves to:
 *
 * {
 *   "label": {
 *     "_createdDate": "2021-01-20T00:31:41.452Z",
 *     "_updatedDate": "2021-01-20T00:31:41.452Z"
 *     "namespace": "custom",
 *     "key": "custom.active-customer",
 *     "displayName": "Active Customer",
 *     "labelType": "USER_DEFINED"
 *   },
 *   "newLabel": true
 * }
 */
```

---