CONTACTS
Import existing ambassadors
6 min
this guide walks you through the process of importing your existing ambassadors into roster whether you're transitioning from a previous platform or starting a new program, these steps will help you seamlessly transfer your ambassador data to roster video walkthrough step by step instructions navigate to the contacts section go to the contacts section in the roster platform locate the import contacts button at the top right hand corner of the screen and select it this will direct you to the data sources section in your brand settings, where you can manage existing and pending contact lists start a new contact import click the import contacts button (pink) in the data sources section provide a name for your list while this step is optional, giving a descriptive name (e g , "previous ambassadors" or "customer list") is recommended for better organization prepare your csv file download this sample csv file for reference before uploading, ensure the file format is csv the social handle columns do not include " com" or similar extensions the email column contains valid and correctly formatted email addresses the country column contains values matching one of the four supported country formats found in the /#valid country codes section below if the program column is included, the spelling must exactly match the spelling of the program in roster there are no special or invalid characters in any field upload your csv file click upload a csv file and select your file roster will verify that the file is in a valid format map your csv columns to roster fields match each column in your csv to a corresponding field in roster first name and email (or social handle ) are required fields optional fields include last name, phone number, address, instagram handles, etc if necessary, create custom properties in roster for additional data complete the upload verify the number of records to ensure it matches your csv file click the complete upload button at the bottom right hand corner of the screen allow a few minutes for the upload to process if errors occur, download the error report to identify and fix issues (e g , special characters or invalid handles) and retry the upload verify imported contacts refresh your data sources page after the upload is complete open the newly imported list to view the contacts navigate to the contacts section to confirm the data has been successfully imported note larger lists may take additional time to fully process valid country codes when including country, ensure that each value exactly matches one of the four supported formats in the following table this table is also available to download as a csv file id name alpha2 alpha3 4 afghanistan af afg 8 albania al alb 12 algeria dz dza 20 andorra ad and 24 angola ao ago 28 antigua & barbuda ag atg 31 azerbaijan az aze 32 argentina ar arg 36 australia au aus 40 austria at aut 44 bahamas bs bhs 48 bahrain bh bhr 50 bangladesh bd bgd 51 armenia am arm 52 barbados bb brb 56 belgium be bel 64 bhutan bt btn 68 bolivia bo bol 70 bosnia & herzegovina ba bih 72 botswana bw bwa 76 brazil br bra 84 belize bz blz 90 solomon islands sb slb 96 brunei bn brn 100 bulgaria bg bgr 104 myanmar (burma) mm mmr 108 burundi bi bdi 112 belarus by blr 116 cambodia kh khm 120 cameroon cm cmr 124 canada ca can 132 cape verde cv cpv 140 central african republic cf caf 144 sri lanka lk lka 148 chad td tcd 152 chile cl chl 156 china cn chn 170 colombia co col 174 comoros km com 178 congo brazzaville cg cog 180 congo kinshasa cd cod 188 costa rica cr cri 191 croatia hr hrv 192 cuba cu cub 196 cyprus cy cyp 203 czechia cz cze 204 benin bj ben 208 denmark dk dnk 212 dominica dm dma 214 dominican republic do dom 218 ecuador ec ecu 222 el salvador sv slv 226 equatorial guinea gq gnq 231 ethiopia et eth 232 eritrea er eri 233 estonia ee est 242 fiji fj fji 246 finland fi fin 250 france fr fra 262 djibouti dj dji 266 gabon ga gab 268 georgia ge geo 270 gambia gm gmb 276 germany de deu 288 ghana gh gha 296 kiribati ki kir 300 greece gr grc 308 grenada gd grd 320 guatemala gt gtm 324 guinea gn gin 328 guyana gy guy 332 haiti ht hti 340 honduras hn hnd 344 hong kong hk hkg 348 hungary hu hun 352 iceland is isl 356 india in ind 360 indonesia id idn 364 iran ir irn 368 iraq iq irq 372 ireland ie irl 376 israel il isr 380 italy it ita 384 côte d’ivoire ci civ 388 jamaica jm jam 392 japan jp jpn 398 kazakhstan kz kaz 400 jordan jo jor 404 kenya ke ken 408 north korea kp prk 410 south korea kr kor 414 kuwait kw kwt 417 kyrgyzstan kg kgz 418 laos la lao 422 lebanon lb lbn 426 lesotho ls lso 428 latvia lv lva 430 liberia lr lbr 434 libya ly lby 438 liechtenstein li lie 440 lithuania lt ltu 442 luxembourg lu lux 450 madagascar mg mdg 454 malawi mw mwi 458 malaysia my mys 462 maldives mv mdv 466 mali ml mli 470 malta mt mlt 478 mauritania mr mrt 480 mauritius mu mus 484 mexico mx mex 492 monaco mc mco 496 mongolia mn mng 498 moldova md mda 499 montenegro me mne need help? if you have any questions or run into issues during the import process, contact us at mailto\ support\@getroster com we're here to help!