Returns contacts from the user's Google Contacts.
class ContactsApp method .getContacts()
ContactsApp is the Apps Script service.
.getContacts() is the method name you will see after a dot in your code.
What it does
Why it's used
- Build a mail-merge list from Google Contacts.
- Sync names and emails into a roster sheet.
Common errors
- Forgetting parentheses on getContacts. Write ContactsApp.getContacts(), not ContactsApp.getContacts or getContacts by itself.
- Skipping dots between chained calls. Each step needs a dot, like ContactsApp.getContacts().
- Adding spaces where they do not belong. Write ContactsApp.getContacts(), not ContactsApp .getContacts(), ContactsApp.getContacts (), or ContactsApp . getContacts().
- Wrong capitalization. Use ContactsApp and getContacts, not contactsapp or getcontacts.
Explore
Related methods
-
.createContact()
Adds a new person to Google Contacts.
-
.getContactGroup()
Returns a contact group by its name or ID.
-
.findByEmailAddress()
Looks up a contact by email address.
More Apps Script
Better Sheets tutorials
No tagged tutorials yet. Fetch Apps Script from the harvest table and this page fills automatically.
Related blog posts
Written guides about ContactsApp.getContacts().